Standardizing Documentation Tasks
The help functionality is the interface
the centos-art.sh script provides to
standardize frequent documentation tasks, based on specific
documentation formats, as described in .
Syntax
centos-art help [OPTIONS] [DOCENTRY]
The DOCENTRY parameter specifies the
documentation entry you want to process. It can be provided
one or more times in the form
MANUAL:PART:CHAPTER:SECTION
or
MANUAL::CHAPTER:SECTION
based on whether the
manual documentation backend you are using supports
structuring through parts or not. When
DOCENTRY parameter is not provided,
&TCAR; Repository File System
documentation
manual is used as default value.
To determine the documentation format to use, when new
documentation manuals are created and no configuration file is
available, the help functionality request
you to enter one of the supported documentation formats and
then, uses it to create the documentation manual. Once the
documentation manual is created, the document configuration
file is available inside the manual directory structure and
used to retrive the document format information, instead.
Options
The help functionality accepts the
following options:
Supress all output messages except error messages. When this
option is passed, all confirmation requests are supressed and
a possitive answer is assumed for them, just as if the
option would have been provided.
Assume yes to all confirmation requests.
Synchronizes available changes between the working copy and
the central repository.
This option looks for KEYWORD inside the
manual specified in the documentation entry and display
related information you to read.
Edit documentation entry related to path specified by
DOCENTRY parameter.
The DOCENTRY parameter must point to any
directory inside the working copy. When more than one
DOCENTRY are passed as non-option
arguments to the centos-art.sh script
command-line, they are queued for further edition. The
edition itself takes place through your default text editor
(e.g., the one you specified in the EDITOR
environment variable) and the text editor opens one file at
time (i.e., the queue of files to edit is not loaded in the
text editor.).
Read documentation entry specified by
DOCENTRY path. This option is used
internally by centos-art.sh script to refer
documentation based on errors, so you can know more about them
and the causes that could have provoked them.
Update output files rexporting them from the specified backend
source files.
Duplicate documentation entries inside the working copy.
When documentation entries are copied, it is required to pass
two non-option parameters in the command-line. The first
non-option parameter is considered the source location and the
second one the target location. Both source location and
target location must point to a directory under the working
copy.
Delete documentation entries specified by
DOCENTRY inside the working copy. It is
possible to delete more than one documentation entry by
specifying more DOCENTRY parameters in the
command-line.
Rename documentation entries inside the working copy.
When documentation entries are renamed, it is required to pass
only two non-option parameters to the command-line. The first
non-option parameter is considered the source location and the
second one the target location. Both source location and
target location must point to a directory under the working
copy.
When documentation entries are removed (e.g., through
or
options), the help functionality takes
care of updating nodes, menus and cross sections related to
documentation entries in order to keep the manual structure in
a consistent state.
Description
...
Function Specific Environment
...
Authors
The following people have worked in the
help functionality:
Alain Reguera Delgado <alain.reguera@gmail.com>, =COPYRIGHT_YEAR_LIST=
License
Copyright © =COPYRIGHT_YEAR_LIST= The CentOS Project
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
USA.