mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-24 11:29:10 +00:00
20ff6c114f
current_chapter_number(). |
||
---|---|---|
.. | ||
doc | ||
info | ||
lib | ||
makeinfo | ||
util | ||
AUTHORS | ||
ChangeLog | ||
ChangeLog.46 | ||
config.h | ||
config.h.in | ||
COPYING | ||
FREEBSD-upgrade | ||
FREEBSD-Xlist | ||
INSTALL | ||
INTRODUCTION | ||
NEWS | ||
README | ||
README.dev | ||
TODO |
$Id: README,v 1.16 2004/12/13 13:36:32 karl Exp $ This is the README file for the GNU Texinfo distribution. Texinfo is the preferred documentation format for GNU software. Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004 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. See ./INSTALL* for installation instructions. Primary distribution point: ftp://ftp.gnu.org/gnu/texinfo/ (list of mirrors at: http://www.gnu.org/prep/ftp.html) Home page: http://www.gnu.org/software/texinfo/ (list of mirrors at: http://www.gnu.org/server/list-mirrors.html) This page includes links to other Texinfo-related programs. Mailing lists and archives: - bug-texinfo@gnu.org for bug reports or enhancement suggestions, archive: http://mail.gnu.org/pipermail/bug-texinfo - help-texinfo@gnu.org for authoring questions and general discussion, archive: http://mail.gnu.org/pipermail/help-texinfo - texinfo-pretest@texinfo.org for pretests of new releases, archive: http://texinfo.org/ftp/texinfo-pretest-archive 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 any input files necessary to reproduce the bug (crucial!). - a description of the problem and any samples of the erroneous output. - the version number of Texinfo and the program(s) involved (use --version). - hardware, operating system, and compiler versions (uname -a). - unusual options you gave to configure, if any (see config.status). - anything else that you think would be helpful. Patches are most welcome; if possible, please make them with diff -c and include ChangeLog entries. When sending email, please do not encode or split the messages in any way if at all possible; it's easier to deal with one large message than many small ones. GNU shar (http://www.gnu.org/software/sharutils/) is a convenient way of packaging multiple and/or binary files for email. See README.dev 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. And 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.dev Texinfo developer information. INSTALL Texinfo-specific installation notes. NEWS Summary of new features by release. INTRODUCTION Brief introduction to the system, and how to create readable files from the Texinfo source files in this distribution. Texinfo documentation files (in ./doc): texinfo.txi 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, makeinfo, and the Emacs Lisp Texinfo formatting commands. info.texi This manual tells you how to use Info. This document also comes as part of GNU Emacs. If you do not have Emacs, you can format this Texinfo source file with makeinfo or TeX and then read the resulting Info file with the standalone Info reader that is part of this distribution. info-stnd.texi This manual tells you how to use the standalone GNU Info reader that is included in this distribution as C source (./info). Printing related files: doc/texinfo.tex This TeX definitions file tells the TeX program how to typeset a Texinfo file into a DVI file ready for printing. 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. Source files for standalone C programs: ./lib ./makeinfo ./info Installation files: Makefile.am What Automake uses to make a Makefile.in. Makefile.in What `configure' uses to make a Makefile, created by Automake. configure.ac What Autoconf uses to create `configure'. configure Configuration script for local conditions, created by Autoconf.