2022-11-16 20:09:17 +08:00
|
|
|
[EditorConfig][]
|
|
|
|
================
|
|
|
|
|
2024-06-07 15:35:12 +08:00
|
|
|
[![GitHub release](https://img.shields.io/github/release/editorconfig/editorconfig-core-c.svg)](../../releases/latest)
|
|
|
|
[![Build Status](https://github.com/editorconfig/editorconfig-core-c/actions/workflows/CI_build.yml/badge.svg)](https://github.com/editorconfig/editorconfig-core-c/actions/workflows/CI_build.yml)
|
2022-11-16 20:09:17 +08:00
|
|
|
[![Build status](https://ci.appveyor.com/api/projects/status/u9t8m4uech5kejoi/branch/master?svg=true)](https://ci.appveyor.com/project/xuhdev/editorconfig-core-c/branch/master)
|
|
|
|
|
|
|
|
EditorConfig makes it easy to maintain the correct coding style when switching
|
|
|
|
between different text editors and between different projects. The
|
|
|
|
EditorConfig project maintains a file format and plugins for various text
|
|
|
|
editors which allow this file format to be read and used by those editors. For
|
|
|
|
information on the file format and supported text editors, see the
|
|
|
|
[EditorConfig website][EditorConfig].
|
|
|
|
|
|
|
|
|
|
|
|
Contributing
|
|
|
|
------------
|
|
|
|
|
|
|
|
This is the README file for the *EditorConfig C Core* codebase. This code
|
|
|
|
produces a program that accepts a filename as input and will look for
|
|
|
|
`.editorconfig` files with sections applicable to the given file, outputting
|
|
|
|
any properties found.
|
|
|
|
|
|
|
|
When developing an editor plugin for reading EditorConfig files, the
|
|
|
|
EditorConfig core code can be used to locate and parse these files. This means
|
|
|
|
the file locator, INI parser, and file globbing mechanisms can all be
|
|
|
|
maintained in one code base, resulting in less code repetition between plugins.
|
|
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
------------
|
|
|
|
|
|
|
|
See the [INSTALL.md][] file for instructions.
|
|
|
|
|
|
|
|
Getting Help
|
|
|
|
------------
|
|
|
|
|
|
|
|
For help with the EditorConfig C Core code, please write to our
|
|
|
|
[mailing list][]. Bugs and feature requests should be submitted to our
|
|
|
|
[issue tracker][]. If you find any security bugs, please send them privately to
|
|
|
|
`hong AT topbug DOT net` -- they need to be embargoed before fixed.
|
|
|
|
|
|
|
|
If you are writing a plugin a language that can import C libraries, you may
|
|
|
|
want to import and use the EditorConfig library directly. If you do use the
|
|
|
|
EditorConfig core as a C library, check the [documentation][] for latest stable
|
|
|
|
version for help. The documentation for latest development version is also
|
|
|
|
available [online][dev doc].
|
|
|
|
|
|
|
|
|
|
|
|
License
|
|
|
|
-------
|
|
|
|
|
|
|
|
Unless otherwise stated, all files are distributed under the Simplified BSD
|
|
|
|
license. The inih(`src/lib/ini.c` and `src/lib/ini.h`) library is distributed
|
|
|
|
under the New BSD license. `src/lib/utarray.h` is distributed under the Revised
|
|
|
|
BSD License. The See LICENSE file for details. Some code in `src/lib/misc.c` is
|
|
|
|
distributed under their own license (see the source file for details). See the
|
|
|
|
LICENSE file for details.
|
|
|
|
|
|
|
|
[EditorConfig]: http://editorconfig.org "EditorConfig Homepage"
|
|
|
|
[INSTALL.md]: https://github.com/editorconfig/editorconfig-core-c/blob/master/INSTALL.md
|
|
|
|
[mailing list]: http://groups.google.com/group/editorconfig "EditorConfig mailing list"
|
|
|
|
[issue tracker]: https://github.com/editorconfig/editorconfig-core-c/issues
|
|
|
|
[documentation]: http://docs.editorconfig.org/ "EditorConfig C Core documentation"
|
|
|
|
[downloads]: https://sourceforge.net/projects/editorconfig/files/EditorConfig-C-Core/
|
|
|
|
[dev doc]: http://docs.editorconfig.org/en/master "EditorConfig C Core latest development version documentation"
|