summaryrefslogtreecommitdiffstats
path: root/CODING_STYLE.rst
Commit message (Collapse)AuthorAgeFilesLines
* CODING_STYLE.rst: Be less strict about 80 character limitPeter Maydell2020-12-131-2/+7
| | | | | | | | | | | | | | Relax the wording about line lengths a little bit; this goes with the checkpatch changes to warn at 100 characters rather than 80. (Compare the Linux kernel commit bdc48fa11e46f8; our coding style is not theirs, but the rationale is good and applies to us too.) Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Reviewed-by: Markus Armbruster <armbru@redhat.com> Reviewed-by: Michael S. Tsirkin <mst@redhat.com> Message-Id: <20201106112940.31300-1-peter.maydell@linaro.org> Signed-off-by: Laurent Vivier <laurent@vivier.eu>
* CODING_STYLE.rst: flesh out our naming conventions.Alex Bennée2020-09-101-2/+35
| | | | | | | | | | Mention a few of the more common naming conventions we follow in the code base including common variable names and function prefix and suffix examples. Signed-off-by: Alex Bennée <alex.bennee@linaro.org> Reviewed-by: Thomas Huth <thuth@redhat.com> Message-Id: <20200909112742.25730-2-alex.bennee@linaro.org>
* docs: split the CODING_STYLE doc into distinct groupsDaniel P. Berrangé2019-09-051-0/+9
| | | | | Reviewed-by: Peter Maydell <peter.maydell@linaro.org> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
* docs: document use of automatic cleanup functions in glibDaniel P. Berrangé2019-09-051-0/+85
| | | | | | | | Document the use of g_autofree and g_autoptr in glib for automatic freeing of memory. Reviewed-by: Alex Bennée <alex.bennee@linaro.org> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
* docs: merge HACKING.rst contents into CODING_STYLE.rstDaniel P. Berrangé2019-09-051-0/+296
| | | | | | | | | The split of information between the two docs is rather arbitary and unclear. It is simpler for contributors if all the information is in one file. Reviewed-by: Alex Bennée <alex.bennee@linaro.org> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
* docs: convert README, CODING_STYLE and HACKING to RST syntaxDaniel P. Berrangé2019-09-051-0/+251
Reviewed-by: Alex Bennée <alex.bennee@linaro.org> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>