Re: [Qemu-devel] [PATCH 0/4] docs: add docs about use of automatic cleanup functions
On Wed, Aug 28, 2019 at 01:30:15PM +0100, Alex Bennée wrote: > > Marc-André Lureau writes: > > > Hi > > > > On Fri, Aug 23, 2019 at 8:41 PM Daniel P. Berrangé > > wrote: > >> > >> This is ostensibly about adding docs for the g_autofree/g_autoptr > >> macros. As part of doing that, however, the existing HACKING doc > >> is merged into the CODING_STYLE doc and the text is converted to > >> markdown with a table of contents. > > > > Why not rst, so it can integrate with the rest of qemu sphinx doc? > > > > (markdown is quite poor when it comes to documenting code or > > cross-referencing etc) > > I was going to say markdown does have the advantage of being renderable > on the fly on code hosting sites but it appears it works on > gitlab/github so that is an argument for being consistent with the rest > of the docs. I picked markdown because most projects seem to use a README.md and CONTRIBUTING.md file with github/gitlab, but if those sites cope with .rst for those files too, there's no reason not to use .rst. > Does anyone know what is left to get the publishing pipeline up and > running and the results linked to from www.qemu.org? Regards, Daniel -- |: https://berrange.com -o-https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o-https://fstop138.berrange.com :| |: https://entangle-photo.org-o-https://www.instagram.com/dberrange :|
Re: [Qemu-devel] [PATCH 0/4] docs: add docs about use of automatic cleanup functions
Re: [Qemu-devel] [PATCH 0/4] docs: add docs about use of automatic cleanup functions
Hi On Fri, Aug 23, 2019 at 8:41 PM Daniel P. Berrangé wrote: > > This is ostensibly about adding docs for the g_autofree/g_autoptr > macros. As part of doing that, however, the existing HACKING doc > is merged into the CODING_STYLE doc and the text is converted to > markdown with a table of contents. Why not rst, so it can integrate with the rest of qemu sphinx doc? (markdown is quite poor when it comes to documenting code or cross-referencing etc) > > Daniel P. Berrangé (4): > docs: convert CODING_STYLE and HACKING to markdown syntax > docs: merge HACKING.md contents into CODING_STYLE.md > docs: document use of automatic cleanup functions in glib > docs: add table of contents to CODING_STYLE.md > > CODING_STYLE| 216 - > CODING_STYLE.md | 613 > HACKING | 257 > README | 2 +- > 4 files changed, 614 insertions(+), 474 deletions(-) > delete mode 100644 CODING_STYLE > create mode 100644 CODING_STYLE.md > delete mode 100644 HACKING > > -- > 2.21.0 > > -- Marc-André Lureau
[Qemu-devel] [PATCH 0/4] docs: add docs about use of automatic cleanup functions
This is ostensibly about adding docs for the g_autofree/g_autoptr macros. As part of doing that, however, the existing HACKING doc is merged into the CODING_STYLE doc and the text is converted to markdown with a table of contents. Daniel P. Berrangé (4): docs: convert CODING_STYLE and HACKING to markdown syntax docs: merge HACKING.md contents into CODING_STYLE.md docs: document use of automatic cleanup functions in glib docs: add table of contents to CODING_STYLE.md CODING_STYLE| 216 - CODING_STYLE.md | 613 HACKING | 257 README | 2 +- 4 files changed, 614 insertions(+), 474 deletions(-) delete mode 100644 CODING_STYLE create mode 100644 CODING_STYLE.md delete mode 100644 HACKING -- 2.21.0