ASCIIDOC(1)
===========
Stuart Rackham <srackham@methods.co.nz>
v5.1.1, September 2004

NAME
----
asciidoc - converts an AsciiDoc text file to DocBook, HTML or LinuxDoc

SYNOPSIS
--------
'asciidoc' -b backend [ -d doctype ] [ -g glossary-entry ]
	 [ -e ] [-n] [ -s ] [ -f configfile ] [ -o outfile ]
	 [ --help | -h ] [ --version ] [ -v ] [ -c ]
	 infile

DESCRIPTION
-----------
The asciidoc(1) command translates the AsciiDoc text file 'infile' to the
'backend' formatted file 'outfile'. If 'infile' is '-' then the standard
input is used.

OPTIONS
-------
--help, -h::
	Print this documentation.

-b::
	Backend output file format: 'docbook', 'linuxdoc', 'html',
	'css' or 'css-embedded'.

-c::
	Dump configuration to stdout.

-e::
	Exclude implicitly loaded configuration files except for those
	named like the input file ('infile.conf' and
	'infile-backend.conf').

-d::
	Document type: 'article', 'manpage' or 'book'. The 'book'
	document type is only supported by the 'docbook' backend and
	the 'manpage' document type is not supported by the 'linuxdoc'
	backend.

-f::
	Use configuration file 'configfile'.

-g::
	Define glossary entry where 'glossary-entry' is formatted like
	'name=value'.  Alternate acceptable forms are 'name' (the
	'value' defaults to an empty string) and '^name' (undefine the
	'name' glossary entry).  Use the '-g section-numbers'
	command-line option to auto-number HTML article section
	titles.

-n::
	Synonym for '-g section-numbers'.

-o::
	Write output to file 'outfile'. Defaults to the base name of input file
	with 'backend' extension. If the input is stdin then the outfile
	defaults to stdout. If 'outfile' is '-' then the standard output is
	used.

-s::
	Suppress document header and footer output.

-v::
	Verbosely print processing information and configuration file
        checks to stderr.

--version::
	Print program version number.

BUGS
----
- Keyboard EOF (Ctrl+D) ignored when reading source from console.
- Reported line numbers in diagnostic messages are sometimes wrong.
- Block filters only work in a POSIX environment.
- Embedding open brace characters { in argument values can cause
  incorrect argument substitution.
- Section numbering is incorrect when outputting HTML from a
  multi-part book type document. This is not a biggy since multi-part
  books are generally processed to DocBook.

AUTHOR
------
Written by Stuart Rackham, <srackham@methods.co.nz>

RESOURCES
---------
SourceForge: http://sourceforge.net/projects/asciidoc/

Main web site: http://www.methods.co.nz/asciidoc/

COPYING
-------
Copyright (C) 2002,2004 Stuart Rackham. Free use of this software is
granted under the terms of the GNU General Public License (GPL).

