Development repository for GSoC 2017

Mathieu Lirzin 99bb097093 iframe: Add proper history management 6 years ago
Pod-Simple-Texinfo 77e93a8030 add missing use directive 7 years ago
build-aux 2f195b82ba gnulib update 6 years ago
contrib 08bf6a0942 revert last revision 8 years ago
djgpp 08bf6a0942 revert last revision 8 years ago
doc 15bef68f2c Macro Details interchange macro and conditional 6 years ago
gnulib 426397dca1 run gnulib-tool --add-import 6 years ago
info 4fa1befe39 info allow style variables to be set 6 years ago
install-info 9dbb60f8f1 update reference test results 8 years ago
js 99bb097093 iframe: Add proper history management 6 years ago
makeinfo 08bf6a0942 revert last revision 8 years ago
man 63e8c5eeff 6.1.90 pretest 7 years ago
po 1ca9b841ca update-po 6 years ago
po_document 1ca9b841ca update-po 6 years ago
texi2html 08bf6a0942 revert last revision 8 years ago
texindex 69ee21bd96 texindex copyright year 2017 6 years ago
tp ec93091934 Fix a typo. 6 years ago
util cbff888af5 remove 6 years ago
.gitignore 6dabda0815 kawa-ebook: Use bundled modules from "src" directory 6 years ago
ABOUT-NLS 7f12bb9773 gettext 0.19.8 6 years ago
AUTHORS 08bf6a0942 revert last revision 8 years ago
COPYING 08bf6a0942 revert last revision 8 years ago
ChangeLog 4fa1befe39 info allow style variables to be set 6 years ago
ChangeLog.46 08bf6a0942 revert last revision 8 years ago
INSTALL 08bf6a0942 revert last revision 8 years ago
INSTALL.generic 08bf6a0942 revert last revision 8 years ago c2bd2350fd change path in po-check target 6 years ago
NEWS 8d55128d7c NEWS 6 years ago
README 08bf6a0942 revert last revision 8 years ago
README-alpha 08bf6a0942 revert last revision 8 years ago
README-hacking c209e3ac01 remove mention of long-checks 6 years ago
TODO 08bf6a0942 revert last revision 8 years ago c1d20425db MiscXS 7 years ago 44ffa0be7d set TEXINFO_XS in configure 6 years ago
system.h 08bf6a0942 revert last revision 8 years ago


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, 2014, 2015, 2016
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:
Including links to Texinfo-related programs not part of this package.

Primary distribution point:
automatic mirror redirection:
mirror list:

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
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 a tutorial on reading Info files:
./info/ginfo doc/info
and/or read the Texinfo manual:
./info/ginfo doc/texinfo

Texinfo mailing lists and archives:
for bug reports, enhancement suggestions, technical discussion.
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 needed 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 (try ./config.status --help).
- 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/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.
texindex/ The `texindex' program that generates
sorted indices used by TeX when
typesetting a file for printing.

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

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

The util/ directory contains a few other scripts, e.g., examples of
using makeinfo in various ways. See util/README.

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.