[6302] doc tweaks

[karl]

Revision: 6302
          http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6302
Author:   karl
Date:     2015-06-03 17:48:34 +0000 (Wed, 03 Jun 2015)
Log Message:
-----------
doc tweaks

Modified Paths:
--------------
    trunk/AUTHORS
    trunk/ChangeLog
    trunk/README-hacking

Modified: trunk/AUTHORS
===================================================================
--- trunk/AUTHORS       2015-06-02 22:10:04 UTC (rev 6301)
+++ trunk/AUTHORS       2015-06-03 17:48:34 UTC (rev 6302)
@@ -1,7 +1,7 @@
 $Id$
 Texinfo authors.
 
-  Copyright 2003, 2005, 2006, 2007, 2008, 2010, 2011
+  Copyright 2003, 2005, 2006, 2007, 2008, 2010, 2011, 2015
   Free Software Foundation, Inc.
   
   Copying and distribution of this file, with or without modification,
@@ -28,8 +28,10 @@
 Philippe Martin                original makeinfo xml/docbook output.
 Sergey Poznyakoff      all files.
 Derek Price            texi2html.
+Arnold Robbins         literate (texi+awk) texindex.
 Paul Rubin             original makeinfo/multi.c.
 Andreas Schwab         texinfo.tex, configure.ac, most makeinfo files.
+Gavin Smith            all files.
 Richard Stallman       original texinfo.tex, install-info.c,
                        texindex.c, texinfo.txi.
 Zack Weinberg          texinfo.tex: @macro implementation.

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog     2015-06-02 22:10:04 UTC (rev 6301)
+++ trunk/ChangeLog     2015-06-03 17:48:34 UTC (rev 6302)
@@ -1,3 +1,9 @@
+2015-06-03  Karl Berry  <address@hidden>
+
+       * AUTHORS (Robbins, Smith): add.
+       * README-hacking: mention TeX by Topic, TeX for the Impatient,
+       and texiwebjr.
+
 2015-06-02  Karl Berry  <address@hidden>
 
        * po_document/Makevars (PACKAGE_GNU, MSGINIT_OPTIONS,

Modified: trunk/README-hacking
===================================================================
--- trunk/README-hacking        2015-06-02 22:10:04 UTC (rev 6301)
+++ trunk/README-hacking        2015-06-03 17:48:34 UTC (rev 6302)
@@ -43,16 +43,6 @@
 diagnostics; however, removing all possible warning messages, or
 warnings with nonfree compilers, is explicitly not a goal.
 
-If you want to delve into making a new backend for the Perl makeinfo,
-the documentation in tp/Texinfo/Convert/Converter.pm is a good starting
-point, as it describes the existing backends and other places to look.
-
-Translations are handled through the Translation Project.  When a new
-.po is posted in
-  http://translationproject.org/latest/texinfo 
-  http://translationproject.org/latest/texinfo_document
-it should be installed.
-
 This distribution also uses Gnulib (http://www.gnu.org/software/gnulib)
 to share common files.  Gnulib files used in Texinfo are checked in to
 the repository.  If you get automake/conf/etc. errors from ./autogen.sh,
@@ -66,11 +56,11 @@
 recorded in gnulib/m4/gnulib-cache.m4.  Given a source checkout of
 gnulib, you can update the files with gnulib-tool --add-import.
 
-And, when running gnulib-tool --add-import or otherwise adding modules,
-remember to check what files were added (e.g., run "svn status build-aux
-gnulib") and add them to the repository with "svn add"; likewise for
-removals.  Likewise for adding new generated files (typically
-gnulib/lib/foo.h from foo.h.in) to the ignore list.
+When running gnulib-tool --add-import or otherwise adding modules, it is
+necessary to check what files were added (e.g., run "svn status
+build-aux gnulib") and add them to the repository with "svn add";
+likewise for removals.  Likewise for adding new generated files
+(typically gnulib/lib/foo.h from foo.h.in) to the ignore list.
 
 
 
@@ -95,8 +85,28 @@
 #!/bin/sh
 exec /YOUR/TEXINFO/CHECKOUT/tp/texi2any.pl "$@"
 
-For information on creating and modifying
+
 
+References for working on various parts of the system:
+
+If you want to delve into making a new backend for the Perl makeinfo,
+the documentation in tp/Texinfo/Convert/Converter.pm is a good starting
+point, as it describes the existing backends and other places to look.
+
+If you want to delve into texinfo.tex, a thorough plain TeX reference
+is available under the GFDL:
+  TeX by Topic - http://www.eijkhout.net/texbytopic/texbytopic.html
+Another book on plain TeX, also available under the GFDL, is a GNU package:
+  TeX for the Impatient - http://www.gnu.org/software/teximpatient/
+
+The texindex program is implemented using the TexiWebJR literate
+programming system, combining Texinfo and Awk
+(https://github.com/arnoldrobbins/texiwebjr).  Running "make ti.pdf"
+in the texindex/ subdirectory creates the printable form of the
+program.  All the usual Texinfo output formats are possible.
+
+
+
 Steps for making a release (pretest or official):
 
 - First checks: