HACKING: Add section about C++ dialect used.

Also add editor aid "comments", like other top-level plain text files.
This commit is contained in:
G. Branden Robinson 2023-06-10 22:43:56 -05:00
parent 7959e9963d
commit 9aeb25f4f7

21
HACKING
View File

@ -10,6 +10,19 @@ system and build groff using the instructions in 'INSTALL.repo'.
Familiarize yourself with the structure of the source tree by studying
its 'MANIFEST' file at the top level.
Implementation languages
------------------------
Beyond what is said under "Dependencies" in 'INSTALL.extra',
contributors should note that due to the age of the code base, much of
the C++ dialect employed by groff components, while standard, is older
than C++98--closer to Annotated Reference Manual C++ (Ellis, Stroustrup;
Addison-Wesley, 1990). groff implements its own string class and the
Standard Template Library is little used. A modest effort is underway
to update the code to more idiomatic C++98. Where a C++11 feature
promises to be advantageous, it may be annotated in a code comment.
Automake
--------
@ -155,3 +168,11 @@ Here are some portability notes on writing automated tests.
N;/Foo[. ][. ]*1/p;
};
}
##### Editor settings
Local Variables:
fill-column: 72
mode: text
End:
vim: set autoindent textwidth=72: