Mercurial > gnulib
changeset 39156:3199892788da
autoupdate
author | Karl Berry <karl@freefriends.org> |
---|---|
date | Fri, 17 Nov 2017 08:34:36 -0800 |
parents | b75cf8075aba |
children | eb213166afee |
files | build-aux/texinfo.tex doc/standards.texi |
diffstat | 2 files changed, 59 insertions(+), 52 deletions(-) [+] |
line wrap: on
line diff
--- a/build-aux/texinfo.tex Mon Nov 13 08:37:38 2017 -0800 +++ b/build-aux/texinfo.tex Fri Nov 17 08:34:36 2017 -0800 @@ -3,7 +3,7 @@ % Load plain if necessary, i.e., if running under initex. \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi % -\def\texinfoversion{2017-09-11.18} +\def\texinfoversion{2017-11-17.06} % % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995, % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, @@ -5969,24 +5969,30 @@ % Split the last of the double-column material. \savemarks \balancecolumns - % + }% + \eject % call the \output just set + \ifdim\pagetotal=0pt % Having called \balancecolumns once, we do not % want to call it again. Therefore, reset \output to its normal % definition right away. \global\output = {\onepageout{\pagecontents\PAGE}}% - }% - \eject - \endgroup % started in \begindoublecolumns - \restoremarks - % Leave the double-column material on the current page, no automatic - % page break. - \box\balancedcolumns - % - % \pagegoal was set to the doubled \vsize above, since we restarted - % the current page. We're now back to normal single-column - % typesetting, so reset \pagegoal to the normal \vsize. - \global\vsize = \txipageheight % - \pagegoal = \txipageheight % + % + \endgroup % started in \begindoublecolumns + \restoremarks + % Leave the double-column material on the current page, no automatic + % page break. + \box\balancedcolumns + % + % \pagegoal was set to the doubled \vsize above, since we restarted + % the current page. We're now back to normal single-column + % typesetting, so reset \pagegoal to the normal \vsize. + \global\vsize = \txipageheight % + \pagegoal = \txipageheight % + \else + % We had some left-over material. This might happen when \doublecolumnout + % is called in \balancecolumns. Try again. + \expandafter\enddoublecolumns + \fi } \newbox\balancedcolumns \setbox\balancedcolumns=\vbox{shouldnt see this}% @@ -6001,6 +6007,7 @@ \ifdim\dimen@<5\baselineskip % Don't split a short final column in two. \setbox2=\vbox{}% + \global\setbox\balancedcolumns=\vbox{\pagesofar}% \else \divide\dimen@ by 2 % target to split to \dimen@ii = \dimen@ @@ -6016,15 +6023,15 @@ \repeat }% % Now the left column is in box 1, and the right column in box 3. + % % Check whether the left column has come out higher than the page itself. % (Note that we have doubled \vsize for the double columns, so % the actual height of the page is 0.5\vsize). \ifdim2\ht1>\vsize - % Just split the last of the double column material roughly in half. - \setbox2=\box0 - \setbox0 = \vsplit2 to \dimen@ii - \setbox0=\vbox to \dimen@ii {\unvbox0\vfill}% - \setbox2=\vbox to \dimen@ii {\unvbox2\vfill}% + % It appears that we have been called upon to balance too much material. + % Output some of it with \doublecolumnout, leaving the rest on the page. + \setbox\PAGE=\box0 + \doublecolumnout \else % Compare the heights of the two columns. \ifdim4\ht1>5\ht3 @@ -6037,10 +6044,10 @@ \setbox2=\vbox to\ht1{\unvbox3\unskip}% \setbox0=\vbox to\ht1{\unvbox1\unskip}% \fi + \global\setbox\balancedcolumns=\vbox{\pagesofar}% \fi \fi % - \global\setbox\balancedcolumns=\vbox{\pagesofar}% } \catcode`\@ = \other
--- a/doc/standards.texi Mon Nov 13 08:37:38 2017 -0800 +++ b/doc/standards.texi Fri Nov 17 08:34:36 2017 -0800 @@ -87,7 +87,7 @@ recently, please check for a newer version. You can get the GNU Coding Standards from the GNU web server in many different formats, including the Texinfo source, PDF, HTML, DVI, plain -text, and more, at: @uref{http://www.gnu.org/prep/standards/}. +text, and more, at: @uref{https://www.gnu.org/prep/standards/}. If you are maintaining an official GNU package, in addition to this document, please read and follow the GNU maintainer information @@ -98,7 +98,7 @@ If you want to receive diffs for every change to these GNU documents, join the mailing list @code{gnustandards-commit@@gnu.org}, via the web interface at -@url{http://lists.gnu.org/mailman/listinfo/gnustandards-commit}. +@url{https://lists.gnu.org/mailman/listinfo/gnustandards-commit}. Archives are also available there. @cindex @code{bug-standards@@gnu.org} email address @@ -111,7 +111,7 @@ source, but if that's difficult for you, you can make a context diff for some other version of this document, or propose it in any way that makes it clear. The source repository for this document can be found -at @url{http://savannah.gnu.org/projects/gnustandards}. +at @url{https://savannah.gnu.org/projects/gnustandards}. These standards cover the minimum of what is important when writing a GNU package. Likely, the need for additional standards will come up. @@ -127,7 +127,7 @@ The GNU Hello program serves as an example of how to follow the GNU coding standards for a trivial program. -@uref{http://www.gnu.org/software/hello/hello.html}. +@uref{https://www.gnu.org/software/hello/hello.html}. This release of the GNU Coding Standards was last updated @value{lastupdate}. @@ -309,7 +309,7 @@ @cindex Guile @cindex GNOME and Guile The standard extensibility interpreter for GNU software is Guile -(@uref{http://www.gnu.org/@/software/@/guile/}), which implements the +(@uref{https://www.gnu.org/@/software/@/guile/}), which implements the language Scheme (an especially clean and simple dialect of Lisp). Guile also includes bindings for GTK+/GNOME, making it practical to write modern GUI functionality within Guile. We don't reject programs @@ -888,7 +888,7 @@ Please make your program interoperate with access technology such as screen readers (see -@url{http://www.gnu.org/accessibility/accessibility.html}). This should +@url{https://www.gnu.org/accessibility/accessibility.html}). This should be automatic if you use GTK+. @node Command-Line Interfaces @@ -1007,7 +1007,7 @@ @smallexample GNU hello 2.3 Copyright (C) 2007 Free Software Foundation, Inc. -License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. @end smallexample @@ -1052,49 +1052,49 @@ @table @asis @item GPL -GNU General Public License, @url{http://www.gnu.org/@/licenses/@/gpl.html}. +GNU General Public License, @url{https://www.gnu.org/@/licenses/@/gpl.html}. @item LGPL -GNU Lesser General Public License, @url{http://www.gnu.org/@/licenses/@/lgpl.html}. +GNU Lesser General Public License, @url{https://www.gnu.org/@/licenses/@/lgpl.html}. @item GPL/Ada GNU GPL with the exception for Ada. @item Apache The Apache Software Foundation license, -@url{http://www.apache.org/@/licenses}. +@url{https://www.apache.org/@/licenses}. @item Artistic -The Artistic license used for Perl, @url{http://dev.perl.org/licenses/artistic.html}. +The Artistic license used for Perl, @url{https://dev.perl.org/licenses/artistic.html}. @item Expat The Expat license, @url{http://www.jclark.com/@/xml/@/copying.txt}. @item MPL -The Mozilla Public License, @url{http://www.mozilla.org/@/MPL/}. +The Mozilla Public License, @url{https://www.mozilla.org/@/MPL/}. @item OBSD The original (4-clause) BSD license, incompatible with the GNU GPL -@url{http://www.xfree86.org/@/3.3.6/@/COPYRIGHT2.html#6}. +@url{https://www.xfree86.org/@/3.3.6/@/COPYRIGHT2.html#6}. @item PHP The license used for PHP, @url{http://www.php.net/@/license/}. @item public domain The non-license that is being in the public domain, -@url{http://www.gnu.org/@/licenses/@/license-list.html#PublicDomain}. +@url{https://www.gnu.org/@/licenses/@/license-list.html#PublicDomain}. @item Python The license for Python, -@url{http://directory.fsf.org/wiki?title=License:Python2.0.1}. +@url{https://directory.fsf.org/wiki?title=License:Python2.0.1}. @item RBSD The revised (3-clause) BSD, compatible with the GNU GPL,@* -@url{http://www.xfree86.org/@/3.3.6/@/COPYRIGHT2.html#5}. +@url{https://www.xfree86.org/@/3.3.6/@/COPYRIGHT2.html#5}. @item X11 The simple non-copyleft license used for most versions of the X Window -System, @url{http://www.xfree86.org/@/3.3.6/@/COPYRIGHT2.html#3}. +System, @url{https://www.xfree86.org/@/3.3.6/@/COPYRIGHT2.html#3}. @item Zlib The license for Zlib, @url{http://www.gzip.org/@/zlib/@/zlib_license.html}. @@ -1103,7 +1103,7 @@ More information about these licenses and many more are on the GNU licensing web pages, -@url{http://www.gnu.org/@/licenses/@/license-list.html}. +@url{https://www.gnu.org/@/licenses/@/license-list.html}. @node --help @@ -1120,13 +1120,13 @@ @cindex bug reports Near the end of the @samp{--help} option's output, please place lines giving the email address for bug reports, the package's home page -(normally @indicateurl{http://www.gnu.org/software/@var{pkg}}, and the +(normally @indicateurl{https://www.gnu.org/software/@var{pkg}}, and the general page for help using GNU programs. The format should be like this: @example Report bugs to: @var{mailing-address} -@var{pkg} home page: <http://www.gnu.org/software/@var{pkg}/> -General help using GNU software: <http://www.gnu.org/gethelp/> +@var{pkg} home page: <https://www.gnu.org/software/@var{pkg}/> +General help using GNU software: <https://www.gnu.org/gethelp/> @end example It is ok to mention other appropriate mailing lists and web pages. @@ -2299,7 +2299,7 @@ The OID (object identifier) 1.3.6.1.4.1.11591 has been assigned to the GNU Project (thanks to Sergey Poznyakoff). These are used for SNMP, LDAP, X.509 certificates, and so on. The web site -@url{http://www.alvestrand.no/objectid} has a (voluntary) listing of +@url{https://www.alvestrand.no/objectid} has a (voluntary) listing of many OID assignments. If you need a new slot for your GNU package, write @@ -3026,7 +3026,7 @@ @end table @cindex Gnulib -@uref{http://www.gnu.org/software/gnulib/, Gnulib} is a big help in +@uref{https://www.gnu.org/software/gnulib/, Gnulib} is a big help in this regard. Gnulib provides implementations of standard interfaces on many of the systems that lack them, including portable implementations of enhanced GNU interfaces, thereby making their use @@ -3479,7 +3479,7 @@ collection. For a single short document, you can use a very permissive non-copyleft license, to avoid taking up space with a long license. -See @uref{http://www.gnu.org/copyleft/fdl-howto.html} for more explanation +See @uref{https://www.gnu.org/copyleft/fdl-howto.html} for more explanation of how to employ the GFDL. Note that it is not obligatory to include a copy of the GNU GPL or GNU @@ -3504,7 +3504,7 @@ of these manuals, the on-line versions of the manual should mention at the very start that the printed manual is available and should point at information for getting it---for instance, with a link to the page -@url{http://www.gnu.org/order/order.html}. This should not be included +@url{https://www.gnu.org/order/order.html}. This should not be included in the printed manual, though, because there it is redundant. It is also useful to explain in the on-line forms of the manual how the @@ -3825,7 +3825,7 @@ Manuals}). Finally, the GNU help2man program -(@uref{http://www.gnu.org/software/help2man/}) is one way to automate +(@uref{https://www.gnu.org/software/help2man/}) is one way to automate generation of a man page, in this case from @option{--help} output. This is sufficient in many cases. @@ -3955,7 +3955,7 @@ alternatives for how to describe a machine. Thus, @samp{athlon-pc-gnu/linux} would be a valid alias. There is a shell script called -@uref{http://git.savannah.gnu.org/@/gitweb/@/?p=config.git;a=blob_plain;f=config.sub;hb=HEAD, +@uref{https://git.savannah.gnu.org/@/gitweb/@/?p=config.git;a=blob_plain;f=config.sub;hb=HEAD, @file{config.sub}} that you can use as a subroutine to validate system types and canonicalize aliases. @@ -3966,7 +3966,7 @@ i686-pc-linux-gnu}. When the build type is not specified by an option or argument, the @code{configure} script should normally guess it using the shell script -@uref{http://git.savannah.gnu.org/@/gitweb/@/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD, +@uref{https://git.savannah.gnu.org/@/gitweb/@/?p=config.git;a=blob_plain;f=config.guess;hb=HEAD, @file{config.guess}}. @cindex optional features, configure-time @@ -4183,13 +4183,13 @@ idea that their existence is ethical. The GNU definition of free software is found on the GNU web site at -@url{http://www.gnu.org/@/philosophy/@/free-sw.html}, and the definition +@url{https://www.gnu.org/@/philosophy/@/free-sw.html}, and the definition of free documentation is found at -@url{http://www.gnu.org/@/philosophy/@/free-doc.html}. The terms ``free'' +@url{https://www.gnu.org/@/philosophy/@/free-doc.html}. The terms ``free'' and ``non-free'', used in this document, refer to those definitions. A list of important licenses and whether they qualify as free is in -@url{http://www.gnu.org/@/licenses/@/license-list.html}. If it is not +@url{https://www.gnu.org/@/licenses/@/license-list.html}. If it is not clear whether a license qualifies as free, please ask the GNU Project by writing to @email{licensing@@gnu.org}. We will answer, and if the license is an important one, we will add it to the list.