[PATCH 05/17] docs: describe the basic RST structure for a man page

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Signed-off-by: Daniel P. Berrangé <berrange@xxxxxxxxxx>
---
 docs/styleguide.rst | 86 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)

diff --git a/docs/styleguide.rst b/docs/styleguide.rst
index 71f29320cb..2998e90963 100644
--- a/docs/styleguide.rst
+++ b/docs/styleguide.rst
@@ -64,3 +64,89 @@ which allows for 6 levels of headings
 
    Heading 6
    ^^^^^^^^^
+
+Manual pages
+============
+
+RST documents created as manual pages must have the following structure
+
+::
+
+  ===========
+  ::PROGRAM::
+  ===========
+
+  ---------------------------
+  ...line line description...
+  ---------------------------
+
+  :Manual section: 8
+  :Manual group: Virtualization Support
+
+  .. contents::
+
+  SYNOPSIS
+  ========
+
+  ``::PROGRAM::`` [*OPTION*]...
+
+  DESCRIPTION
+  ===========
+
+  ...describe the tool / program ...
+
+  OPTIONS
+  =======
+
+  ``-h``, ``--help``
+
+  Display command line help usage then exit.
+
+  ...and other args....
+
+  FILES
+  =====
+
+  ...any files used that the user needs to know about. eg config
+  files in particular...
+
+  AUTHORS
+  =======
+
+  Please refer to the AUTHORS file distributed with libvirt.
+
+  BUGS
+  ====
+
+  Please report all bugs you discover.  This should be done via either:
+
+  #. the mailing list
+
+   `https://libvirt.org/contact.html <https://libvirt.org/contact.html>`_
+
+  #. the bug tracker
+
+   `https://libvirt.org/bugs.html <https://libvirt.org/bugs.html>`_
+
+  Alternatively, you may report bugs to your software distributor / vendor.
+
+
+  COPYRIGHT
+  =========
+
+  Copyright (C) ::DATE:: ::ORIGINAL AUTHOR::, and the authors listed in the
+  libvirt AUTHORS file.
+
+  LICENSE
+  =======
+
+  ``::PROGRAM::`` is distributed under the terms of the GNU LGPL v2.1+.
+  This is free software; see the source for copying conditions. There
+  is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
+  PURPOSE
+
+  SEE ALSO
+  ========
+
+  ...other man page links....
+  `https://www.libvirt.org/ <https://www.libvirt.org/>`_
-- 
2.23.0

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list




[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]

  Powered by Linux