texinfo-commits
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

branch master updated: * INSTALL: integrate text from doc/README about *


From: Gavin D. Smith
Subject: branch master updated: * INSTALL: integrate text from doc/README about *.tex installation. use https: for ftp.gnu.org link. * doc/README: eliminate file. * doc/Makefile.am (install-data-local): update reference to INSTALL.
Date: Tue, 15 Aug 2023 09:27:47 -0400

This is an automated email from the git hooks/post-receive script.

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 2b0d8d35de * INSTALL: integrate text from doc/README about *.tex 
installation. use https: for ftp.gnu.org link. * doc/README: eliminate file. * 
doc/Makefile.am (install-data-local): update reference to INSTALL.
2b0d8d35de is described below

commit 2b0d8d35dec29b8b97e9f502e206d59d057f09c1
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Tue Aug 15 14:23:11 2023 +0100

    * INSTALL: integrate text from doc/README about *.tex installation.
    use https: for ftp.gnu.org link.
    * doc/README: eliminate file.
    * doc/Makefile.am (install-data-local): update reference to INSTALL.
---
 ChangeLog       |  7 +++++++
 INSTALL         | 43 ++++++++++++++++++++++++++++++++++++-------
 doc/Makefile.am |  2 +-
 doc/README      | 42 ------------------------------------------
 4 files changed, 44 insertions(+), 50 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index d3e8eddb0e..bfadcdeecf 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2023-08-15  Gavin Smith <gavinsmith0123@gmail.com>
+
+       * INSTALL: integrate text from doc/README about *.tex installation.
+       use https: for ftp.gnu.org link.
+       * doc/README: eliminate file.
+       * doc/Makefile.am (install-data-local): update reference to INSTALL.
+
 2023-08-15  Gavin Smith <gavinsmith0123@gmail.com>
 
        * info/session.c: removed unused variable.
diff --git a/INSTALL b/INSTALL
index ca1c727671..b03f8a71c3 100644
--- a/INSTALL
+++ b/INSTALL
@@ -12,16 +12,45 @@ Automake-based distribution, please read the file 
`INSTALL.generic'.
 Installation notes specific to Texinfo:
 
 * texinfo.tex and the other *.tex files are not installed by
-  `make install', because there is no reliable way to know where to
-  install them.  Instead, you have to run an additional make command
+  `make install', because TeX installations vary so widely.
+  Installing them in the wrong place would give a false sense of
+  security.   Instead, you have to run an additional make command
   after the normal make install:
+
     make TEXMF=/your/texmf install-tex
-  texinfo.tex is installed in ${TEXMF}/tex/texinfo/texinfo.tex, etc.
-  More information is available in doc/README.
 
-* On the other hand, if you're maintaining a TeX distribution and
-  keeping the files up to date yourself, you may not want to see the
-  installation warnings.
+  where TEXMF is a root of a TeX hierachy that follows the TeX
+  Directory Structure standard (http://tug.org/tds/).
+  texinfo.tex is installed in ${TEXMF}/tex/texinfo, epsf.tex
+  in ${TEXMF}/tex/generic/epsf/, etc.
+
+  (Alternatively, you can simply cp *.tex to the appropriate places.)
+
+  For information on how or where to install files, see your TeX
+  documentation in general (i.e. web2c and kpathsea manuals), and the
+  texmf.cnf file.
+
+  It is possible to put these .tex files in a `local' place instead of
+  overwriting existing ones.  You might find where this is by running
+  `kpsewhich -var-value TEXMFLOCAL'.
+
+  If you add files to your TeX installations, not just replace existing
+  ones, you very likely will also have to update your ls-R file; do this
+  by running the mktexlsr command.
+
+  An alternative is to copy texinfo.tex to the same directory as your
+  Texinfo manual, but this is not especially recommended.
+
+  You can get the latest texinfo.tex from
+  https://ftp.gnu.org/gnu/texinfo/texinfo.tex (and all GNU mirrors)
+  ftp://tug.org/tex/texinfo.tex (and all CTAN mirrors)
+  or from the gnulib project on Savannah (among other places).
+  If you have problems with the texinfo.tex in this distribution, please
+  check for a newer version.
+
+* If you're maintaining a TeX distribution and keeping the files up to
+  date yourself, you may not want to see the installation warnings.
+
   For that, run configure --disable-install-warnings, or set
   enable_install_warnings=no in the environment.
 
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 2fe7892e36..3d79657ac8 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -74,7 +74,7 @@ install-data-local:
        @echo "             texinfo.tex and txi-??.tex manually,"
        @echo "         perhaps in TEXMF/tex/texinfo/,"
        @echo "         where TEXMF is a root of your TeX tree."
-       @echo "         See doc/README for some considerations."
+       @echo "         See INSTALL for some considerations."
        @echo "         You can run make TEXMF=/your/texmf install-tex to do 
this."
        @echo
        @echo "         You may also need to install epsf.tex in"
diff --git a/doc/README b/doc/README
deleted file mode 100644
index 8e2f9d70e9..0000000000
--- a/doc/README
+++ /dev/null
@@ -1,42 +0,0 @@
-texinfo/doc/README
-
-  Copyright 2002-2021 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.
-
-This directory contains documentation on the Texinfo system and the TeX
-sources needed to process Texinfo sources.
-
-The .tex files are not installed automatically because TeX
-installations vary so widely.  Installing them in the wrong place
-would give a false sense of security.  So to allow "\input texinfo"
-in your Texinfo files to find the correct version of texinfo.tex,
-you should simply cp *.tex to the appropriate place.
-
-If your installation follows the TeX Directory Structure
-standard (http://tug.org/tds/), this place will be the directory
-TEXMF/tex/texinfo/ for texinfo.tex, and TEXMF/tex/generic/epsf/ for
-epsf.tex, where TEXMF is a root of a TeX hierachy.
-
-It is possible to put these .tex files in a `local' place instead
-of overwriting existing ones.  You might find  where this is by running
-`kpsewhich -var-value TEXMFLOCAL'.
-
-If you add files to your TeX installations, not just replace existing
-ones, you very likely will also have to update your ls-R file; do
-this by running the mktexlsr command.
-
-For information on how or where to install files, see your TeX documentation
-in general (i.e. web2c and kpathsea manuals), and the texmf.cnf file.
-
-An alternative is to copy texinfo.tex to the same directory as your
-Texinfo manual, but this is not especially recommended.
-
-You can get the latest texinfo.tex from
-ftp://ftp.gnu.org/gnu/texinfo/texinfo.tex (and all GNU mirrors)
-ftp://tug.org/tex/texinfo.tex (and all CTAN mirrors)
-or from the gnulib project on Savannah (among other places).
-If you have problems with the texinfo.tex in this distribution, please check
-for a newer version.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]