mirror of
https://github.com/php/php-src.git
synced 2024-09-23 10:57:26 +00:00
03f3b8479b
This patch adds missing newlines, trims multiple redundant final newlines into a single one, and trims redundant leading newlines. According to POSIX, a line is a sequence of zero or more non-' <newline>' characters plus a terminating '<newline>' character. [1] Files should normally have at least one final newline character. C89 [2] and later standards [3] mention a final newline: "A source file that is not empty shall end in a new-line character, which shall not be immediately preceded by a backslash character." Although it is not mandatory for all files to have a final newline fixed, a more consistent and homogeneous approach brings less of commit differences issues and a better development experience in certain text editors and IDEs. [1] http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_206 [2] https://port70.net/~nsz/c/c89/c89-draft.html#2.1.1.2 [3] https://port70.net/~nsz/c/c99/n1256.html#5.1.1.2 |
||
---|---|---|
.. | ||
acinclude.m4 | ||
base64.c | ||
base64.h | ||
encodings.c | ||
encodings.h | ||
queue.c | ||
queue.h | ||
README | ||
simplestring.c | ||
simplestring.h | ||
system_methods_private.h | ||
system_methods.c | ||
xml_element.c | ||
xml_element.h | ||
xml_to_dandarpc.c | ||
xml_to_dandarpc.h | ||
xml_to_soap.c | ||
xml_to_soap.h | ||
xml_to_xmlrpc.c | ||
xml_to_xmlrpc.h | ||
xmlrpc_introspection_private.h | ||
xmlrpc_introspection.c | ||
xmlrpc_introspection.h | ||
xmlrpc_private.h | ||
xmlrpc_win32.h | ||
xmlrpc.c | ||
xmlrpc.h | ||
xmlrpc.m4 |
organization of this directory is moving towards this approach: <module>.h -- public API and data types <module>_private.h -- protected API and data types <module>.c -- implementation and private API / types The rules are: .c files may include *_private.h. .h files may not include *_private.h This allows us to have a nicely encapsulated C api with opaque data types and private functions that are nonetheless shared between source files without redundant extern declarations..