Menu
CTAN
Comprehensive TeX Archive Network
Cover Upload Browse

Direc­tory tex-archive/macros/texinfo/texinfo

$Id: README 5320 2013-08-16 13:50:01Z karl $
This is the README file for the GNU Texinfo distribution.  Texinfo is
the preferred documentation format for GNU software.

  Copyright 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001,
  2002, 2003, 2004, 2009, 2010, 2011, 2012, 2013
  Free Software Foundation, Inc.

  Copying and distribution of this file, with or without modification,
  are permitted in any medium without royalty provided the copyright
  notice and this notice are preserved.

Home page: http://www.gnu.org/software/texinfo/
  This page includes links to other Texinfo-related programs.

Primary distribution point: http://ftp.gnu.org/gnu/texinfo/
  automatic mirror redirection: http://ftpmirror.gnu.org/texinfo/
                   mirror list: http://www.gnu.org/prep/ftp.html

Texinfo is a documentation system that uses a single source to produce
many forms of output:
- a PDF or DVI document (via the TeX typesetting system) with the normal
  features of a book, including sectioning, cross references, indices, etc.
- an Info file with analogous features to make documentation browsing easy.
- a plain text (ASCII) file.
- an HTML output file suitable for use with a web browser.
- a Docbook file.
- a XML file transliterating the source with a Texinfo DTD.

See ./INSTALL* for installation instructions.

To get started with Texinfo, best is to read the Texinfo manual;
it is online at http://www.gnu.org/software/texinfo/manual/texinfo.
If you don't have Internet access, you can read the manual locally:
- first, build the distribution.
- then, for HTML, run: make -C doc html
  and you can start reading at doc/texinfo.html/index.html.
- for PDF, if you have a working TeX, run: make -C doc pdf
- for Info, you can read about the Info reader itself with:
 ./info/ginfo doc/info
  and then read the Texinfo manual:
 ./info/ginfo doc/texinfo

Texinfo mailing lists and archives:
- http://lists.gnu.org/mailman/listinfo/bug-texinfo
  for bug reports, enhancement suggestions, technical discussion.
- http://lists.gnu.org/mailman/listinfo/help-texinfo
  for authoring questions and general discussion.
There are no corresponding newsgroups.

Bug reports:
Please include enough information for the maintainers to reproduce the
problem.  Generally speaking, that means:
- the contents of all input files necessary to reproduce the bug (crucial!).
- a statement of the problem and any samples of the erroneous output.
- the version number of Texinfo and the program(s) involved (use --version).
- hardware and operating system information (uname -a).
- unusual options you gave to configure, if any (see config.status).
- anything else that you think could be helpful.

Patches are most welcome; if possible, please make them with diff -c and
include ChangeLog entries.

See README-hacking for information on the Texinfo development
environment -- any interested parties are welcome.  If you're a
programmer and wish to contribute, this should get you started.  If
you're not a programmer, you can still make significant contributions by
writing test cases, checking the documentation against the
implementation, etc.

This distribution includes the following files, among others:
    README                 This file.
    README-hacking         Texinfo developer information.

    INSTALL                Texinfo-specific installation notes.
    NEWS                   Summary of new features by release.

Texinfo documentation files (in ./doc):
    texinfo.texi           Describes the Texinfo language and many
                           of the associated tools.  It tells how to use
                           Texinfo to write documentation, how to use
                           Texinfo mode in GNU Emacs, TeX,
                           texi2any/makeinfo, and much else.

    info.texi              Describes how to read manuals in Info.
                           This document also comes as part of GNU Emacs.

    info-stnd.texi         How to use the standalone GNU Info reader that is
                           included in this distribution (./info).

Printing-related files:
    doc/texinfo.tex        This implements Texinfo in TeX, to typeset a
                           Texinfo file into a DVI or PDF file.

    util/texindex.c        This file contains the source for
                           the `texindex' program that generates
                           sorted indices used by TeX when
                           typesetting a file for printing.

    util/texi2dvi          This is a shell script for producing an
                           indexed DVI file using TeX and texindex.
    
    util/texi2pdf          Generate PDF (wrapper for texi2dvi).

Source directories: 
  djgpp/                   Support for compiling under DJGPP.
  gnulib/                  Support files from Gnulib.
  info/                    Standalone Info reader.
  install-info/            Maintain the Info dir file.
  tp/                      Texinfo Parser in Perl, includes texi2any/makeinfo.

Translation support:
  po/                      Strings of the programs.
  po_document/             Strings in generated Texinfo documents.

Installation support:
  Makefile.am              Read by Automake to create a Makefile.in.
  Makefile.in              Read by configure to make a Makefile,
                             created by Automake.
  configure.ac             Read by Autoconf to create `configure'.
  configure                Configuration script for local conditions,
                             created by Autoconf.
  build-aux/               Common files.

Finally, the contrib/ directory contains additional files from users
provided for your reading and/or hacking pleasure.  They aren't part of
Texinfo proper or maintained by the Texinfo developers.

Direc­to­ries

Name Notes
Pod-Simple-Texinfo
build-aux
contrib
djgpp
doc
gnulib
info
install-info
man
po
po_document
tp
util

Files

Name Size Date Notes
ABOUT-NLS 93787 2013-08-18 07:33
AUTHORS 2210 2013-02-23 01:11
COPYING 35147 2013-02-19 11:25
ChangeLog 436817 2013-09-26 11:50
ChangeLog.46 437205 2013-02-19 11:25
INSTALL 1850 2013-08-16 02:50
INSTALL.generic 15752 2013-09-13 05:52
Makefile.am 3364 2013-03-20 01:00
Makefile.in 53663 2013-09-27 12:04
NEWS 46419 2013-09-27 12:06
README 5802 2013-08-16 02:50
README-hacking 6776 2013-09-27 12:04
TODO 10627 2013-09-09 07:03
aclocal.m4 45326 2013-09-27 12:04
config.in 46125 2013-09-27 12:04
configure 664795 2013-09-27 12:04
configure.ac 14931 2013-09-27 12:04
system.h 6734 2013-02-23 01:11

Down­load the con­tents of this pack­age in one zip archive (10.4M).

tex­info – Tex­info doc­u­men­ta­tion sys­tem

Tex­info is the pre­ferred for­mat for doc­u­men­ta­tion in the GNU project; the for­mat may be used to pro­duce on­line or printed out­put from a sin­gle source.

The Tex­info macros may be used to pro­duce print­able out­put us­ing TeX; other pro­grams in the dis­tri­bu­tion of­fer on­line in­ter­ac­tive use (with hy­per­text link­ages in some cases).

Note that a de­vel­op­ers’ snap­shot of the lat­est re­lease of the Tex­info macros may be found in the Tex­info ‘lat­est’ pack­age.

Pack­age De­tailstex­info
Home pagehttp://www.gnu.org/soft­ware/tex­info/
Ver­sion5.1
Li­censeGNU Gen­eral Public Li­cense
Copy­right1985-2013 Free Soft­ware Foun­da­tion, Inc.
Main­tainerEli Zaret­skii
Karl Berry
Free Soft­ware Foun­da­tion
Con­tained inMikTeX as mik­tex-tex­info-base
Topics macros to build a for­mat
macros and tools for prepar­ing doc­u­men­ta­tion
Guest Book Sitemap Contact