diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2017-11-12 11:54:45 -0500 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2017-11-12 12:01:41 -0500 |
commit | fe01b8f92fd4c2be5ec83de9acf2b4ab3107df68 (patch) | |
tree | d16d920c17f096c20dbd1425049e2d862633f777 /arch | |
parent | 7e1b85e68d11eb11f1c47f26c5f56ff3e0ba0b11 (diff) | |
download | groff-git-fe01b8f92fd4c2be5ec83de9acf2b4ab3107df68.tar.gz |
arch: Make style fixes.
* Refer to the X Window System correctly.
* Migrate comments and plain text from `quotes' to 'quotes'.
* Similarly from ``quotes'' to "quotes".
* Remove trailing whitespace from lines near other changes.
Deliberately not done: recognition of the consolidation of GNU
fileutils, shellutils, and textutils into coreutils. This happened in
2003, but I wouldn't want anyone to get the idea that the groff port to
DJGPP has been checked since then. _I_ sure haven't done it.
Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Diffstat (limited to 'arch')
-rw-r--r-- | arch/djgpp/README | 69 | ||||
-rw-r--r-- | arch/djgpp/config.bat | 2 | ||||
-rw-r--r-- | arch/djgpp/config.site | 2 | ||||
-rw-r--r-- | arch/misc/shdeps.sh | 28 |
4 files changed, 52 insertions, 49 deletions
diff --git a/arch/djgpp/README b/arch/djgpp/README index 0fe7f26d0..b8ca7a3b4 100644 --- a/arch/djgpp/README +++ b/arch/djgpp/README @@ -1,12 +1,12 @@ Copyright (C) 2000-2014 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. + 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 is a port of GNU Groff to DJGPP v2.03 or later. Groff is the GNU version of document formatting tools related to -`troff'. +'troff'. This README file describes how to build and install Groff on MS-DOS or MS-Windows systems using the DJGPP port of GNU C/C++ compiler and @@ -19,8 +19,8 @@ I. Installing the pre-compiled binary package 1. Unzip the file groNNNb.zip (where NNN is the version number) preserving the directory structure (-d switch to PKUNZIP) from the main DJGPP installation directory. If you will use Groff - on Windows 9X or Windows2000, use an unzip program which - supports long filenames. + on Windows 9x, Windows 2000, or later, use an unzip program + which supports long filenames. 2. Groff binaries were configured so that they will look for their standard directories under the directory pointed to by the @@ -34,7 +34,7 @@ I. Installing the pre-compiled binary package GROFF_TYPESETTER=ascii GROFF_FONT_PATH=%DJDIR%/share/groff/<version>/font - <version> is something like `1.16.1' or `1.17'. + <version> is something like '1.16.1' or '1.17'. In addition, you can set the variable GROFF_TMPDIR to point to a directory where you want Groff to create temporary files it @@ -48,7 +48,7 @@ I. Installing the pre-compiled binary package installed. Note that the GROFF_TYPESETTER variable sets the default Groff - device to be `ascii', which is suitable for formatting man + device to be 'ascii', which is suitable for formatting man pages to be viewed on the terminal. Use the -T switch to generate output for other devices (e.g., -Tps for PostScript). @@ -72,7 +72,7 @@ I. Installing the pre-compiled binary package under construction, so some sections are empty. If you want to add a Groff entry to the main Info menu in the - file DIR, chdir to the `info' subdirectory of the main Groff + file DIR, chdir to the 'info' subdirectory of the main Groff installation directory and run this command: install-info --dir-file=dir groff.info @@ -84,14 +84,14 @@ I. Installing the pre-compiled binary package groff -man -s foo.1 > foo.man - where `foo.1' is the troff source of the man page and `foo.man' + where 'foo.1' is the troff source of the man page and 'foo.man' is the formatted page. If you need to view the man page, say this: groff -man -s foo.1 | less - You can also use the DJGPP clone of the Unix `man' command, in - which case `man' runs the above command for you automatically. + You can also use the DJGPP clone of the Unix 'man' command, in + which case 'man' runs the above command for you automatically. Here's how you print man pages on a PostScript printer: @@ -103,20 +103,20 @@ I. Installing the pre-compiled binary package Printing the documents produced by Groff is possible either by redirecting Groff's standard output to the local printer - device, like shown above, or by using the `-l' switch to Groff. + device, like shown above, or by using the '-l' switch to Groff. The latter possibility causes Groff to pipe its output to a program whose name and arguments appear in the files named - `DESC' in each of the `devFOO' subdirectories of the + 'DESC' in each of the 'devFOO' subdirectories of the %DJDIR%/share/groff/<version>/font directory; for example, the file devps/DESC is used by "groff -Tps". The relevant line in these files begins with the word "print". - As configured, when invoked with the `-l' switch, Groff will - call `cat' (from GNU Textutils) to pipe its output to the + As configured, when invoked with the '-l' switch, Groff will + call 'cat' (from GNU Textutils) to pipe its output to the default printer device for -Tps, -Tlbp and -Tlj4 options, and - it will call `dvilj4' (from the dvljNNNb.zip package) for -Tdvi + it will call 'dvilj4' (from the dvljNNNb.zip package) for -Tdvi option. If you don't have these programs installed, you can - edit the respective `DESC' files to replace these commands with + edit the respective 'DESC' files to replace these commands with something else. The replacement program must be able to read its standard input and send its output to whatever printer you want. The "print" entry is assumed to be a shell command, so @@ -149,7 +149,7 @@ I. Installing the pre-compiled binary package - egrep - sed - The `afmtodit' and `mmroff' utilities are Perl scripts, so you + The 'afmtodit' and 'mmroff' utilities are Perl scripts, so you will need a Perl port to run them. All of these ports should be available from the DJGPP sites. @@ -171,8 +171,8 @@ I. Installing the pre-compiled binary package 8. The package does not include the directories under share/groff/<version>/font whose names begin with "devX": these - are needed on X-Windows for running the gxditview program, which - is not supported by this port. + are needed on the X Window System for running the gxditview + program, which is not supported by this port. 9. Due to 8+3 limitations of DOS filesystems, several files were renamed: @@ -215,22 +215,22 @@ II. Building Groff from sources Special considerations apply if you have GCC 2.8.1 installed, and cannot upgrade to a later version. See paragraph 4 below. - After you install these tools, make sure you have a ``symlink'' - to bash.exe called sh.exe and a ``symlink'' to gawk.exe called + After you install these tools, make sure you have a "symlink" + to bash.exe called sh.exe and a "symlink" to gawk.exe called awk.exe. If not, go to the DJGPP bin/ subdirectory and type the following words of wisdom from the DOS prompt: ln -s bash.exe sh.exe ln -s gawk.exe awk.exe - (`ln' is part of GNU Fileutils, see above.) + ('ln' is part of GNU Fileutils, see above.) 2. Unzip the source distribution groXYZs.zip (where XYZ is the version number) preserving the directory structure (-d switch to PKUNZIP) from the main DJGPP installation directory. (If - you are building Groff on Windows 9X or Windows 2000, use an - unzip program which supports long filenames.) This creates - directory gnu/groff-X.YZ and unzips the sources there. + you are building Groff on Windows 9x, Windows 2000, or later, + use an unzip program which supports long filenames.) This + creates directory gnu/groff-X.YZ and unzips the sources there. If you are building from the official GNU distribution, unpack the .tar.gz archive like this: @@ -286,7 +286,7 @@ II. Building Groff from sources The problem with redefining NULL should not happen with DJGPP v2.03 or later. But if you still see compilation errors which - say "`NULL' undeclared", comment out the line in _G_config.h + say "'NULL' undeclared", comment out the line in _G_config.h that says this: #undef NULL @@ -313,7 +313,7 @@ II. Building Groff from sources read it to make yourself familiar with the programs.) Note that the batch file sets a lot of environment variables; - if you get ``Out of environment space'' messages, launch a + if you get "Out of environment space" messages, launch a subsidiary COMMAND.COM with plenty of environment space, like so: @@ -330,7 +330,7 @@ II. Building Groff from sources be installed under the top DJGPP installation directory. Alternatively, you could instruct Make explicitly where to - install the package by setting the `prefix' variable. For + install the package by setting the 'prefix' variable. For example: make install prefix=c:/groff @@ -341,7 +341,7 @@ II. Building Groff from sources will need to format them. Use the commands shown in chapter I, section 5 above to do that, and redirect its output to the appropriate catN subdirectory. Alternatively, you could format - the pages when you need to view them (the DJGPP clone of `man' + the pages when you need to view them (the DJGPP clone of 'man' will automatically format them). Consult the installation instructions for pre-compiled binaries @@ -349,10 +349,13 @@ II. Building Groff from sources 8. You can safely delete the directories under share/groff/<version>/font whose names begin with "devX": these - are needed on X-Windows which is not supported by this port. + are used by the X Window System client 'gxditview', which is + not supported by this port. -##### Emacs settings +##### Editor settings Local Variables: mode: text +fill-column: 70 End: +vim: set autoindent textwidth=70: diff --git a/arch/djgpp/config.bat b/arch/djgpp/config.bat index 48eca861e..aa422274d 100644 --- a/arch/djgpp/config.bat +++ b/arch/djgpp/config.bat @@ -31,7 +31,7 @@ if not "%CONFIG_SITE%" == "%XSRC%/arch/djgpp/config.site" goto SmallEnv Rem This is required because DOS/Windows are case-insensitive
Rem to file names, and "make install" will do nothing if Make
-Rem finds a file called `install'.
+Rem finds a file called 'install'.
if exist INSTALL ren INSTALL INSTALL.txt
Rem Set HOSTNAME so it shows in config.status
diff --git a/arch/djgpp/config.site b/arch/djgpp/config.site index 2925419a4..1df7dd7ed 100644 --- a/arch/djgpp/config.site +++ b/arch/djgpp/config.site @@ -34,5 +34,5 @@ LPR=${LPR='cat >>PRN'} DVIPRINT=${DVIPRINT='dvilj4 - >>PRN'} PERL=${PERL='/usr/bin/perl'} -# Force `cp' to be used instead of "ln -s". +# Force "cp" to be used instead of "ln -s". ac_cv_prog_LN_S="cp -p" diff --git a/arch/misc/shdeps.sh b/arch/misc/shdeps.sh index 4ccd5cee0..cdb409e60 100644 --- a/arch/misc/shdeps.sh +++ b/arch/misc/shdeps.sh @@ -1,29 +1,29 @@ #! /bin/sh -# shdeps.sh: Generate OS dependency fixups, for `groff' shell scripts +# shdeps.sh: Generate OS dependency fixups, for 'groff' shell scripts # # Copyright (C) 2004-2014 Free Software Foundation, Inc. # Written by Keith Marshall (keith.d.marshall@ntlworld.com) # -# Invoked only by `make', as: +# Invoked only by 'make', as: # $(SHELL) shdeps.sh "$(RT_SEP)" "$(SH_SEP)" "$(bindir)" > shdeps.sed -# +# # This file is part of groff. -# +# # groff is free software; you can redistribute it and/or modify it under # the terms of the GNU General Public License as published by the Free # Software Foundation, either version 3 of the License, or # (at your option) any later version. -# +# # groff 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 General Public License # for more details. -# +# # You should have received a copy of the GNU General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. cat << ETX -# shdeps.sed: Script generated automatically by \`make' -- do not modify! +# shdeps.sed: Script generated automatically by 'make' -- do not modify! /^$/N /@GROFF_BIN_PATH_SETUP@/c\\ @@ -31,10 +31,10 @@ ETX if [ "$1$2" = "::" ] then - # `PATH_SEPARATOR' is `:' both at `groff' run time, and in `make', + # 'PATH_SEPARATOR' is ':' both at 'groff' run time, and in 'make', # implying an implementation which is completely POSIX compliant. - # Simply apply the `GROFF_BIN_PATH' and `PATH_SEPARATOR' values - # determined by `configure', in all cases. + # Simply apply the 'GROFF_BIN_PATH' and 'PATH_SEPARATOR' values + # determined by 'configure', in all cases. cat << ETX \\ @@ -43,13 +43,13 @@ GROFF_RUNTIME="\${GROFF_BIN_PATH=$3}:" ETX else - # `PATH_SEPARATOR' is NOT always `:', + # 'PATH_SEPARATOR' is NOT always ':', # which suggests an implementation for a Microsoft platform. - # We need to choose the `GROFF_BIN_PATH' format and `PATH_SEPARATOR' + # We need to choose the 'GROFF_BIN_PATH' format and 'PATH_SEPARATOR' # which will suit the user's choice of shell. # - # Note that some Windows users may specify the `--prefix' path - # using backslash characters, instead of `/', preferred by POSIX, + # Note that some Windows users may specify the '--prefix' path + # using backslash characters, instead of '/', preferred by POSIX, # so we will also fix that up. POSIX_BINDIR=`echo $3 | tr '\\\\' /` |