Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TEXI2ANY(1)			 User Commands			   TEXI2ANY(1)

       texi2any	- translate Texinfo documents

       makeinfo	[OPTION]... TEXINFO-FILE...

       Translate Texinfo source	documentation to various other formats,	by de-
       fault Info files	suitable for reading online with Emacs	or  standalone
       GNU Info.

       This  program  is commonly installed as both `makeinfo' and `texi2any';
       the behavior is identical, and does not depend on the installed name.

   General options:
       --document-language=STR locale to use in	translating Texinfo keywords
	      for the output document (default C).

	      quit after NUM errors (default 100).

	      preserve output even if errors.

       --help display this help	and exit.

	      suppress node cross-reference validation.

	      suppress warnings	(but not errors).

	      search also for initialization files in DIR.

	      load FILE	to modify the default behavior.

       -c, --set-customization-variable	VAR=VAL
	      set customization	variable VAR to	value VAL.

       -v, --verbose
	      explain what is being done.

	      display version information and exit.

   Output format selection (default is to produce Info):
	      output Docbook XML rather	than Info.

       --html output HTML rather than Info.

	      output plain text	rather than Info.

       --xml  output Texinfo XML rather	than Info.

       --dvi, --dvipdf,	--ps, --pdf
	      call texi2dvi to generate	given output, after checking  validity
	      of TEXINFO-FILE.

   General output options:
       -E, --macro-expand=FILE
	      output macro-expanded source to FILE, ignoring any @setfilename.

	      suppress	node separators, Node: lines, and menus	from Info out-
	      put (thus	producing plain	text) or  from	HTML  (thus  producing
	      shorter  output).	  Also,	 if  producing Info, write to standard
	      output by	default.

	      suppress any splitting of	the output; generate only  one	output

	      output chapter and sectioning numbers; default is	on.

       -o, --output=DEST
	      output to	DEST.  With split output, create DEST as a directory

       and put the output files	there.
	      With non-split output, if	DEST is	already

       a directory or ends with	a /,
	      put the output file there.

	      Otherwise, DEST names the	output file.

   Options for Info and	plain text:
	      do  not  output  accented	 and special characters	in Info	output
	      based on @documentencoding.

	      override --disable-encoding (default).

	      break Info lines at NUM characters (default 72).

	      output footnotes in Info according to STYLE: `separate'  to  put
	      them  in	their  own  node;  `end' to put	them at	the end	of the
	      node, in which they are defined (this is the default).

	      indent Info paragraphs by	VAL spaces (default  3).   If  VAL  is
	      `none',  do  not indent; if VAL is `asis', preserve existing in-

	      split Info files at size NUM (default 300000).

   Options for HTML:
	      include FILE in HTML <style> output; read	stdin if FILE is -.

	      generate CSS reference to	URL.

	      produce list of internal links in	FILE.

	      split at SPLIT, where  SPLIT  may	 be  `chapter',	 `section'  or

	      use file names in	ASCII transliteration.

	      produce  redirection files for nodes and anchors;	default	is set
	      only if split.

   Options for XML and Docbook:
	      does nothing, retained for compatibility.

   Options for DVI/PS/PDF:
	      pass OPT to texi2dvi; can	be repeated.

   Input file options:
	      does nothing, retained for compatibility.

       -D VAR define the variable VAR, as with @set.

       -D 'VAR VAL'
	      define VAR to VAL	(one shell argument).

       -I DIR append DIR to the	@include search	path.

       -P DIR prepend DIR to the @include search path.

       -U VAR undefine the variable VAR, as with @clear.

   Conditional processing in input:
	      process @ifdocbook and @docbook even if not generating Docbook.

	      process @ifhtml and @html	even if	not generating HTML.

	      process @ifinfo even if not generating Info.

	      process @ifplaintext even	if not generating plain	text.

	      process @iftex and @tex.

	      process @ifxml and @xml.

	      do not process @ifdocbook	and @docbook text.

	      do not process @ifhtml and @html text.

	      do not process @ifinfo text.

	      do not process @ifplaintext text.

	      do not process @iftex and	@tex text.

	      do not process @ifxml and	@xml text.

       Also, for the --no-ifFORMAT options, do process @ifnotFORMAT text.

       The defaults for	the @if... conditionals	depend on the  output  format:
       if  generating  Docbook,	 --ifdocbook  is on and	the others are off; if
       generating HTML,	--ifhtml is on and the others are off;	if  generating
       Info,  --ifinfo is on and the others are	off; if	generating plain text,
       --ifplaintext is	on and the others are off; if generating XML,  --ifxml
       is on and the others are	off.

       makeinfo	foo.texi
	      write Info to foo's @setfilename

       makeinfo	--html foo.texi
	      write HTML to @setfilename

       makeinfo	--xml foo.texi
	      write Texinfo XML	to @setfilename

       makeinfo	--docbook foo.texi
	      write Docbook XML	to @setfilename

       makeinfo	--plaintext foo.texi
	      write plain text to standard output

       makeinfo	--pdf foo.texi
	      write PDF	using texi2dvi

       makeinfo	--html --no-headers foo.texi
	      write html without node lines, menus

       makeinfo	--number-sections foo.texi
	      write Info with numbered sections

       makeinfo	--no-split foo.texi
	      write one	Info file however big

       Email bug reports to, general questions and discus-
       sion to
       Texinfo home page:

       Copyright (C) 2017 Free Software	Foundation, Inc.  License GPLv3+:  GNU
       GPL version 3 or	later <>
       This  is	 free  software:  you  are free	to change and redistribute it.
       There is	NO WARRANTY, to	the extent permitted by	law.

       The full	documentation for texi2any is maintained as a Texinfo  manual.
       If  the info and	texi2any programs are properly installed at your site,
       the command

	      info texi2any

       should give you access to the complete manual.

texi2any 6.7			September 2019			   TEXI2ANY(1)


Want to link to this manual page? Use this URL:

home | help