asciidoc.1 in mizuho-0.9.8

- old
+ new
@@ -1,155 +1,266 @@
+'\" t
 .\"     Title: asciidoc
-.\"    Author: 
-.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
-.\"      Date: 01/02/2009
-.\"    Manual: 
-.\"    Source: 
+.\"    Author: [see the "AUTHOR" section]
+.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
+.\"      Date: 20 May 2011
+.\"    Manual: \ \&
+.\"    Source: \ \& 8.6.5
+.\"  Language: English
 .\"
-.TH "ASCIIDOC" "1" "01/02/2009" "" ""
+.TH "ASCIIDOC" "1" "20 May 2011" "\ \& 8\&.6\&.5" "\ \&"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
 .ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
 .SH "NAME"
-asciidoc - converts an AsciiDoc text file to DocBook, HTML or LinuxDoc
+asciidoc \- converts an AsciiDoc text file to HTML or DocBook
 .SH "SYNOPSIS"
-\fBasciidoc\fR [\fIOPTIONS\fR] \fIFILE\fR
 .sp
+\fBasciidoc\fR [\fIOPTIONS\fR] \fIFILE\fR
 .SH "DESCRIPTION"
-The asciidoc(1) command translates the AsciiDoc text file \fIFILE\fR to a DocBook, HTML or LinuxDoc file\. If \fIFILE\fR is \fI\-\fR then the standard input is used\.
 .sp
+The asciidoc(1) command translates the AsciiDoc text file \fIFILE\fR to DocBook or HTML\&. If \fIFILE\fR is \fI\-\fR then the standard input is used\&.
 .SH "OPTIONS"
 .PP
 \fB\-a, \-\-attribute\fR=\fIATTRIBUTE\fR
 .RS 4
-Define or delete document attribute\.
+Define or delete document attribute\&.
 \fIATTRIBUTE\fR
 is formatted like
-\fINAME=VALUE\fR\. Command\-line attributes take precedence over document and configuration file attributes\. Alternate acceptable forms are
+\fINAME=VALUE\fR\&. Command\-line attributes take precedence over document and configuration file attributes\&. Alternate acceptable forms are
 \fINAME\fR
 (the
 \fIVALUE\fR
 defaults to an empty string);
 \fINAME!\fR
 (delete the
 \fINAME\fR
 attribute);
-\fINAME@\fR
-(do not override document or configuration file attributes)\. Values containing spaces should be enclosed in double\-quote characters\. This option may be specified more than once\.
+\fINAME=VALUE@\fR
+(do not override document or configuration file attributes)\&. Values containing spaces should be enclosed in double\-quote characters\&. This option may be specified more than once\&. A special attribute named
+\fItrace\fR
+controls the output of diagnostic information\&.
 .RE
 .PP
 \fB\-b, \-\-backend\fR=\fIBACKEND\fR
 .RS 4
 Backend output file format:
-\fIdocbook\fR,
-\fIxhtml11\fR
+\fIdocbook45\fR,
+\fIxhtml11\fR,
+\fIhtml4\fR,
+\fIwordpress\fR
 or
-\fIhtml4\fR\. Defaults to
-\fIxhtml11\fR\.
+\fIlatex\fR
+(the
+\fIlatex\fR
+backend is experimental)\&. You can also the backend alias names
+\fIhtml\fR
+(aliased to
+\fIxhtml11\fR) or
+\fIdocbook\fR
+(aliased to
+\fIdocbook45\fR)\&. Defaults to
+\fIhtml\fR\&.
 .RE
 .PP
 \fB\-f, \-\-conf\-file\fR=\fICONF_FILE\fR
 .RS 4
 Use configuration file
-\fICONF_FILE\fR\.Configuration files processed in command\-line order (after implicit configuration files)\. This option may be specified more than once\.
+\fICONF_FILE\fR\&.Configuration files processed in command\-line order (after implicit configuration files)\&. This option may be specified more than once\&.
 .RE
 .PP
+\fB\-\-doctest\fR
+.RS 4
+Run Python doctests in
+\fIasciidoc\fR
+module\&.
+.RE
+.PP
 \fB\-d, \-\-doctype\fR=\fIDOCTYPE\fR
 .RS 4
 Document type:
 \fIarticle\fR,
 \fImanpage\fR
 or
-\fIbook\fR\. The
+\fIbook\fR\&. The
 \fIbook\fR
 document type is only supported by the
 \fIdocbook\fR
-backend\. Default document type is
-\fIarticle\fR\.
+backend\&. Default document type is
+\fIarticle\fR\&.
 .RE
 .PP
 \fB\-c, \-\-dump\-conf\fR
 .RS 4
-Dump configuration to stdout\.
+Dump configuration to stdout\&.
 .RE
 .PP
-\fB\-h, \-\-help\fR[=\fITOPIC\fR]
+\fB\-\-filter\fR
 .RS 4
-Print help TOPIC\.
-\fB\-\-help\fR=\fItopics\fR
+Manage asciidoc(1) filters (see
+\fBFILTER COMMANDS\fR)\&.
+.RE
+.PP
+\fB\-h, \-\-help\fR [\fITOPIC\fR]
+.RS 4
+Print help TOPIC\&.
+\fB\-\-help\fR
+\fItopics\fR
 will print a list of help topics,
-\fB\-\-help\fR=\fIsyntax\fR
+\fB\-\-help\fR
+\fIsyntax\fR
 summarizes AsciiDoc syntax,
-\fB\-\-help\fR=\fImanpage\fR
-prints the AsciiDoc manpage\.
+\fB\-\-help\fR
+\fImanpage\fR
+prints the AsciiDoc manpage\&.
 .RE
 .PP
 \fB\-e, \-\-no\-conf\fR
 .RS 4
-Exclude implicitly loaded configuration files except for those named like the input file (\fIinfile\.conf\fR
+Exclude implicitly loaded configuration files except for those named like the input file (\fIinfile\&.conf\fR
 and
-\fIinfile\-backend\.conf\fR)\.
+\fIinfile\-backend\&.conf\fR)\&.
 .RE
 .PP
 \fB\-s, \-\-no\-header\-footer\fR
 .RS 4
-Suppress document header and footer output\.
+Suppress document header and footer output\&.
 .RE
 .PP
 \fB\-o, \-\-out\-file\fR=\fIOUT_FILE\fR
 .RS 4
 Write output to file
-\fIOUT_FILE\fR\. Defaults to the base name of input file with
+\fIOUT_FILE\fR\&. Defaults to the base name of input file with
 \fIbackend\fR
-extension\. If the input is stdin then the outfile defaults to stdout\. If
+extension\&. If the input is stdin then the outfile defaults to stdout\&. If
 \fIOUT_FILE\fR
 is
 \fI\-\fR
-then the standard output is used\.
+then the standard output is used\&.
 .RE
 .PP
 \fB\-n, \-\-section\-numbers\fR
 .RS 4
-Auto\-number HTML article section titles\. Synonym for
-\fB\-a numbered\fR\.
+Auto\-number HTML article section titles\&. Synonym for
+\fB\-a numbered\fR\&.
 .RE
 .PP
-\fB\-\-unsafe\fR
+\fB\-\-safe\fR
 .RS 4
-Disable safe mode\. Safe mode is enabled by default, disabling it is potentially dangerous\.
+Enable safe mode\&. Safe mode is disabled by default\&. AsciiDoc
+\fIsafe mode\fR
+skips potentially dangerous scripted sections in AsciiDoc source files\&.
 .RE
 .PP
 \fB\-v, \-\-verbose\fR
 .RS 4
-Verbosely print processing information and configuration file checks to stderr\.
+Verbosely print processing information and configuration file checks to stderr\&.
 .RE
 .PP
 \fB\-\-version\fR
 .RS 4
-Print program version number\.
+Print program version number\&.
 .RE
+.SH "FILTER COMMANDS"
+.sp
+The \fB\-\-filter\fR option is used to install, remove and list AsciiDoc filter plugins\&. Filter commands syntax:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+asciidoc \-\-filter install ZIP_FILE [FILTERS_DIR]
+asciidoc \-\-filter remove FILTER_NAME [FILTERS_DIR]
+asciidoc \-\-filter list
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+Where:
+.PP
+\fBFILTER_NAME\fR
+.RS 4
+A unique filter name containing only alphanumeric or underscore characters\&.
+.RE
+.PP
+\fBZIP_FILE\fR
+.RS 4
+A Zip file containing filter resources, the name must start with the filter name e\&.g\&.
+my_filter\-1\&.0\&.zip
+packages filter
+my_filter\&.
+.RE
+.PP
+\fBFILTERS_DIR\fR
+.RS 4
+The directory containing installed filters\&. Each filter is contained in its own separate subdirectory which has the same name as the filter\&.
+\fBFILTERS_DIR\fR
+defaults to the
+\&.asciidoc/filters
+directory in the user\(cqs home directory\&.
+.RE
+.sp
+The filter commands perform as follows:
+.PP
+\fBinstall\fR
+.RS 4
+Create a subdirectory in
+\fBFILTERS_DIR\fR
+with the same name as the filter then extract the
+\fBZIP_FILE\fR
+into it\&.
+.RE
+.PP
+\fBremove\fR
+.RS 4
+Delete the
+\fBFILTER_NAME\fR
+filter subdirectory and all its contents from the
+\fBFILTERS_DIR\fR\&.
+.RE
+.PP
+\fBlist\fR
+.RS 4
+List the names and locations of all installed filters (including standard filters installed in the global configuration directory)\&.
+.RE
 .SH "EXIT STATUS"
 .PP
 \fB0\fR
 .RS 4
 Success
 .RE
 .PP
 \fB1\fR
 .RS 4
-Failure (syntax or usage error; configuration error; document processing failure; unexpected error)\.
+Failure (syntax or usage error; configuration error; document processing failure; unexpected error)\&.
 .RE
 .SH "BUGS"
-See the AsciiDoc distribution BUGS file\.
 .sp
+See the AsciiDoc distribution BUGS file\&.
 .SH "AUTHOR"
-Written by Stuart Rackham, <srackham@gmail\.com>
 .sp
+AsciiDoc was originally written by Stuart Rackham\&. Many people have contributed to it\&.
 .SH "RESOURCES"
-SourceForge: http://sourceforge\.net/projects/asciidoc/
 .sp
-Main web site: http://www\.methods\.co\.nz/asciidoc/
+SourceForge: http://sourceforge\&.net/projects/asciidoc/
 .sp
+Main web site: http://www\&.methods\&.co\&.nz/asciidoc/
 .SH "COPYING"
-Copyright (C) 2002\-2008 Stuart Rackham\. Free use of this software is granted under the terms of the GNU General Public License (GPL)\.
 .sp
+Copyright (C) 2002\-2011 Stuart Rackham\&. Free use of this software is granted under the terms of the GNU General Public License (GPL)\&.