diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/maintain.texi | 20 | ||||
| -rw-r--r-- | doc/make-stds.texi | 6 | ||||
| -rw-r--r-- | doc/standards.texi | 16 |
3 files changed, 21 insertions, 21 deletions
diff --git a/doc/maintain.texi b/doc/maintain.texi index dcbc4d1bc8..57d03ff015 100644 --- a/doc/maintain.texi +++ b/doc/maintain.texi @@ -309,7 +309,7 @@ distribute the package, and the standing to defend its GPL-covered status in court if necessary. GNU packages need not be FSF-copyrighted; this is up to the author(s), -generally at the time the package is dubbed GNU. When copyright is +generally at the time the package is dubbed GNU@. When copyright is assigned to the FSF, the FSF can act to stop GPL violations about the package. Otherwise, legal actions are up to the author(s). The rest of this section is about the case when a package is FSF-copyrighted. @@ -408,7 +408,7 @@ After receiving the necessary form, the contributor needs to sign it. Contributors residing in the USA or Italy may use GPG in order to sign their assignment. Contributors located anywhere else can print, sign, and then email (or fax) a scanned copy back to the -FSF. (Specific instructions for both cases are sent with the +FSF@. (Specific instructions for both cases are sent with the assignment form.) They may use postal mail, if they prefer. To emphasize, the necessary distinction is between residents and non-residents of these countries; citizenship does not matter. @@ -846,7 +846,7 @@ or both in parallel, as here. GNU @var{package} is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU General Public License for more details. You should have received copies of the GNU General Public License and @@ -870,7 +870,7 @@ You can use whichever is the most convenient for you. @item The @code{gnulib} project on @code{savannah.gnu.org}, which you -can access via anonymous Git or CVS. See +can access via anonymous Git or CVS@. See @uref{https://savannah.gnu.org/projects/gnulib}. @end itemize @@ -898,7 +898,7 @@ License, or (at your option) any later version. GNU @var{package} is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License @@ -916,7 +916,7 @@ the Free Software Foundation; either version 3 of the License, or This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE@. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License @@ -1036,7 +1036,7 @@ separately-published general-purpose free modules? (We also call them matter whether they are packaged as libraries or not.) It would be unreasonable to ask their authors to assign copyright to -the FSF. They didn't write those modules as contributions to GNU. We +the FSF@. They didn't write those modules as contributions to GNU@. We just happen to want to use them, as any developer might. It would be rude to ask developers, out of the blue, to give the FSF their copyright. Please don't ask for that in cases like these. @@ -1487,7 +1487,7 @@ version, and checking that the result exactly matches the new version. @section Binary Distribution for Nonfree Platforms Some package maintainers release pre-compiled binaries for proprietary -systems such as Microsoft Windows or MacOS. It's entirely up to you +systems such as Microsoft Windows or MacOS@. It's entirely up to you whether to do that; we don't ask you to do it, but we don't object. Please do not let anyone make you feel you have an obligation to do this. @@ -2567,7 +2567,7 @@ well. @cindex GNU/Linux The GNU Project was formed to develop a free Unix-like operating system, -GNU. The existence of this system is our major accomplishment. +GNU@. The existence of this system is our major accomplishment. However, the widely used version of the GNU system, in which Linux is used as the kernel, is often called simply ``Linux''. As a result, most users don't know about the GNU Project's major accomplishment---or more @@ -2623,7 +2623,7 @@ itself (@pxref{Terminology}). Likewise, avoid promoting nonfree programs (@pxref{References,,, standards, GNU Coding Standards}) as you would in the package itself. -Many GNU users have erroneous ideas about GNU. Outside of our +Many GNU users have erroneous ideas about GNU@. Outside of our community, most people think it is Linux. Please use your opportunity to set them straight. Start the presentation with the answers to these basic questions: diff --git a/doc/make-stds.texi b/doc/make-stds.texi index d37b24418d..b0745a8a3e 100644 --- a/doc/make-stds.texi +++ b/doc/make-stds.texi @@ -549,15 +549,15 @@ should normally be @file{/usr/local/include}, but write it as Most compilers other than GCC do not look for header files in directory @file{/usr/local/include}. So installing the header files this way is -only useful with GCC. Sometimes this is not a problem because some -libraries are only really intended to work with GCC. But some libraries +only useful with GCC@. Sometimes this is not a problem because some +libraries are only really intended to work with GCC@. But some libraries are intended to work with other compilers. They should install their header files in two places, one specified by @code{includedir} and one specified by @code{oldincludedir}. @item oldincludedir The directory for installing @samp{#include} header files for use with -compilers other than GCC. This should normally be @file{/usr/include}. +compilers other than GCC@. This should normally be @file{/usr/include}. (If you are using Autoconf, you can write it as @samp{@@oldincludedir@@}.) The Makefile commands should check whether the value of diff --git a/doc/standards.texi b/doc/standards.texi index 5c2d97c0d2..c7021fdbb9 100644 --- a/doc/standards.texi +++ b/doc/standards.texi @@ -290,7 +290,7 @@ account when designing your program. @cindex programming languages When you want to use a language that gets compiled and runs at high -speed, the best language to use is C. C++ is ok too, but please don't +speed, the best language to use is C@. C++ is ok too, but please don't make heavy use of templates. So is Java, if you compile it. When highest efficiency is not required, other languages commonly used @@ -303,7 +303,7 @@ the more users are able to extend and combine them (@pxref{The Emacs Thesis,,, guile, GNU Guile Reference Manual}). Many programs are designed to be extensible: they include an interpreter -for a language that is higher level than C. Often much of the program +for a language that is higher level than C@. Often much of the program is written in that language, too. The Emacs editor pioneered this technique. @@ -951,7 +951,7 @@ so that the same jobs can be done from scripts. @cindex keyboard interface @cindex library interface Please also consider providing a D-bus interface for use from other -running programs, such as within GNOME. (GNOME used to use CORBA +running programs, such as within GNOME@. (GNOME used to use CORBA for this, but that is being phased out.) In addition, consider providing a library interface (for use from C), and perhaps a keyboard-driven console interface (for use by users from console @@ -2936,7 +2936,7 @@ versions. For a GNU program, this kind of portability is desirable, but not paramount. The primary purpose of GNU software is to run on top of the GNU kernel, -compiled with the GNU C compiler, on various types of CPU. So the +compiled with the GNU C compiler, on various types of CPU@. So the kinds of portability that are absolutely necessary are quite limited. But it is important to support Linux-based GNU systems, since they are the form of GNU that is popular. @@ -3583,7 +3583,7 @@ 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 -LGPL in a manual whose license is neither the GPL nor the LGPL. It can +LGPL in a manual whose license is neither the GPL nor the LGPL@. It can be a good idea to include the program's license in a large manual; in a short manual, whose size would be increased considerably by including the program's license, it is probably better not to include it. @@ -3676,7 +3676,7 @@ you. Instead of using a file named @file{ChangeLog}, you can record the change log information as log entries in a version control system such -as RCS or CVS. This can be converted automatically to a +as RCS or CVS@. This can be converted automatically to a @file{ChangeLog} file using @code{rcs2log}; in Emacs, the command @kbd{C-x v a} (@code{vc-update-change-log}) does the job. @@ -3949,7 +3949,7 @@ with the FSF about the individual case. @cindex releasing Making a release is more than just bundling up your source files in a -tar file and putting it up for FTP. You should set up your software so +tar file and putting it up for FTP@. You should set up your software so that it can be configured to run on a variety of systems. Your Makefile should conform to the GNU standards described below, and your directory layout should also conform to the standards discussed below. Doing so @@ -4252,7 +4252,7 @@ names for one file in different directories, because certain file systems cannot handle this and that prevents unpacking the distribution. -Try to make sure that all the file names will be unique on MS-DOS. A +Try to make sure that all the file names will be unique on MS-DOS@. A name on MS-DOS consists of up to 8 characters, optionally followed by a period and up to three characters. MS-DOS will truncate extra characters both before and after the period. Thus, |