From a732f8499e1b21df4704d2d8b046c0c7dcc4f7a3 Mon Sep 17 00:00:00 2001 From: "Chris St. Pierre" Date: Wed, 7 Nov 2012 13:34:35 -0500 Subject: doc: made format of man page option lists consistent --- doc/man/bcfg2-lint.txt | 56 +++++++++++++++++++++++--------------------------- 1 file changed, 26 insertions(+), 30 deletions(-) (limited to 'doc/man/bcfg2-lint.txt') diff --git a/doc/man/bcfg2-lint.txt b/doc/man/bcfg2-lint.txt index 1cfedad4e..b7206bd31 100644 --- a/doc/man/bcfg2-lint.txt +++ b/doc/man/bcfg2-lint.txt @@ -1,3 +1,4 @@ +.. -*- mode: rst -*- .. vim: ft=rst bcfg2-lint @@ -27,36 +28,31 @@ tool. Options ------- --C *configfile* - Specify alternate bcfg2.conf location. - --Q - Specify the server repository path. - --v - Be verbose. - ---lint-config - Specify path to bcfg2-lint.conf (default ``/etc/bcfg2-lint.conf``). - ---stdin - Rather than operating on all files in the Bcfg2 specification, only - validate a list of files supplied on stdin. This mode is - particularly useful in pre-commit hooks. - - This makes a few assumptions: - - Metadata files will only be checked if a valid chain of - XIncludes can be followed all the way from clients.xml or - groups.xml. Since there are multiple formats of metadata stored - in Metadata/ (i.e., clients and groups), there is no way to - determine which sort of data a file contains unless there is a - valid chain of XIncludes. It may be useful to always specify all - metadata files should be checked, even if not all of them have - changed. - - Property files will only be validated if both the property file - itself and its matching schema are included on stdin. +-C configfile Specify alternate bcfg2.conf location. +-Q path Specify the path to the server repository. +-v Be verbose. +--lint-config Specify path to bcfg2-lint.conf (default + ``/etc/bcfg2-lint.conf``). +--stdin Rather than operating on all files in the Bcfg2 + specification, only validate a list of files + supplied on stdin. This mode is particularly useful + in pre-commit hooks. + + This makes a few assumptions: + + Metadata files will only be checked if a valid chain + of XIncludes can be followed all the way from + clients.xml or groups.xml. Since there are multiple + formats of metadata stored in Metadata/ (i.e., + clients and groups), there is no way to determine + which sort of data a file contains unless there is a + valid chain of XIncludes. It may be useful to always + specify all metadata files should be checked, even + if not all of them have changed. + + Property files will only be validated if both the + property file itself and its matching schema are + included on stdin. Plugins ------- -- cgit v1.2.3-1-g7c22