diff options
| -rw-r--r-- | appendixa/autoconf-desc.xml | 8 | ||||
| -rw-r--r-- | appendixa/automake-desc.xml | 4 | ||||
| -rw-r--r-- | appendixa/bash-desc.xml | 4 | ||||
| -rw-r--r-- | appendixa/binutils-desc.xml | 3 | ||||
| -rw-r--r-- | appendixa/bison-desc.xml | 6 | ||||
| -rw-r--r-- | appendixa/findutils-desc.xml | 18 | ||||
| -rw-r--r-- | appendixa/flex-desc.xml | 2 | ||||
| -rw-r--r-- | appendixa/gcc-desc.xml | 7 |
8 files changed, 27 insertions, 25 deletions
diff --git a/appendixa/autoconf-desc.xml b/appendixa/autoconf-desc.xml index b6d2f3554..081973535 100644 --- a/appendixa/autoconf-desc.xml +++ b/appendixa/autoconf-desc.xml @@ -34,8 +34,8 @@ statements for configure to use <sect3><title>autoreconf</title> <para> -If you have a lot of Autoconf-generated configure scripts, the -autoreconf program can save you some work. It runs autoconf (and +If there are a lot of Autoconf-generated configure scripts, the +autoreconf program can save some work. It runs autoconf (and autoheader, where appropriate) repeatedly to remake the Autoconf configure scripts and configuration header templates in the directory tree rooted at the current directory. @@ -46,7 +46,7 @@ tree rooted at the current directory. <sect3><title>autoscan</title> <para> -The autoscan program can help you create a configure.in file for +The autoscan program can help to create a configure.in file for a software package. autoscan examines source files in the directory tree rooted at a directory given as a command line argument, or the current directory if none is given. It searches the source files for @@ -71,7 +71,7 @@ Autoconf macros by their old names to use the current macro names. ifnames can help when writing a configure.in for a software package. It prints the identifiers that the package already uses in C preprocessor conditionals. If a package has already been set up to -have some portability, this program can help you figure out what its +have some portability, this program can help to figure out what its configure needs to check for. It may help fill in some gaps in a configure.in generated by autoscan. </para> diff --git a/appendixa/automake-desc.xml b/appendixa/automake-desc.xml index 97cc37327..82ae11569 100644 --- a/appendixa/automake-desc.xml +++ b/appendixa/automake-desc.xml @@ -13,8 +13,8 @@ The Automake package contains the aclocal and automake programs <para> Automake includes a number of Autoconf macros which can be used in -your package; some of them are actually required by Automake in certain -situations. These macros must be defined in your aclocal.m4; +packages; some of them are actually required by Automake in certain +situations. These macros must be defined in the aclocal.m4-file; otherwise they will not be seen by autoconf. </para> diff --git a/appendixa/bash-desc.xml b/appendixa/bash-desc.xml index 6c1a7e225..aef324cbb 100644 --- a/appendixa/bash-desc.xml +++ b/appendixa/bash-desc.xml @@ -12,8 +12,8 @@ The Bash package contains the bash program <para> Bash is the Bourne-Again SHell, which is a widely used command interpreter on Unix systems. Bash is a program that reads from standard -input, the keyboard. You type something and the program will evaluate -what you have typed and do something with it, like running a program. +input, the keyboard. A user types something and the program will evaluate +what he has typed and do something with it, like running a program. </para> </sect2> diff --git a/appendixa/binutils-desc.xml b/appendixa/binutils-desc.xml index 776b5bfdc..486bb07be 100644 --- a/appendixa/binutils-desc.xml +++ b/appendixa/binutils-desc.xml @@ -146,7 +146,8 @@ modified copies under different names. <sect3><title>c++filt</title> <para> -The C++ language provides function overloading, which means that you can +The C++ language provides function overloading, which means that it is +possible to write many functions with the same name (providing each takes parameters of different types). All C++ function names are encoded into a low-level assembly label (this process is known as mangling). The c++filt program diff --git a/appendixa/bison-desc.xml b/appendixa/bison-desc.xml index 7e3fff7e9..b576186ed 100644 --- a/appendixa/bison-desc.xml +++ b/appendixa/bison-desc.xml @@ -14,7 +14,7 @@ Bison is a parser generator, a replacement for YACC. YACC stands for Yet Another Compiler Compiler. What is Bison then? It is a program that generates a program that analyses the structure of a textfile. Instead of -writing the actual program you specify how things should be connected +writing the actual program a user specifies how things should be connected and with those rules a program is constructed that analyses the textfile. </para> @@ -52,8 +52,8 @@ to the compiler: </literallayout></blockquote> <para> -You start at the bottom of a tree and you come across the numbers 2 and -3 which are joined by the multiplication symbol, so the computers +Starting at the bottom of a tree and coming across the numbers 2 and +3 which are joined by the multiplication symbol, the computer multiplies 2 and 3. The result of that multiplication is remembered and the next thing that the computer sees is the result of 2*3 and the number 1 which are joined by the add symbol. Adding 1 to the previous diff --git a/appendixa/findutils-desc.xml b/appendixa/findutils-desc.xml index 4aaa829c4..042644c04 100644 --- a/appendixa/findutils-desc.xml +++ b/appendixa/findutils-desc.xml @@ -25,10 +25,10 @@ current directory and it's subdirectories. <para> Locate scans a database which contain all files and directories on a filesystem. This program lists the files and directories in this -database matching a certain criteria. If you're looking for a file this -program will scan the database and tell you exactly where the files you -requested are located. This only makes sense if your locate database is -fairly up-to-date else it will provide you with out-of-date information. +database matching a certain criteria. If a user is looking for a file this +program will scan the database and tell him exactly where the files he +requested are located. This only makes sense if the locate database is +fairly up-to-date else it will provide out-of-date information. </para> </sect3> @@ -38,10 +38,10 @@ fairly up-to-date else it will provide you with out-of-date information. <para> The updatedb program updates the locate database. It scans the entire file system (including other file system that are currently mounted -unless you specify it not to) and puts every directory and file it finds +unless it is told not to do so) and puts every directory and file it finds into the database that's used by the locate program which retrieves this -information. It's a good practice to update this database once a day so -that you are ensured of a database that is up-to-date. +information. It's a good practice to update this database once a day to +have it up-to-date whenever it is needed. </para> </sect3> @@ -49,8 +49,8 @@ that you are ensured of a database that is up-to-date. <sect3><title>Xargs</title> <para> -The xargs command applies a command to a list of files. If you need to -perform the same command on multiple files, you can create a file that +The xargs command applies a command to a list of files. If there is a need to +perform the same command on multiple files, a file can be created that contains all these files (one per line) and use xargs to perform that command on the list. </para> diff --git a/appendixa/flex-desc.xml b/appendixa/flex-desc.xml index f62592463..26fbff577 100644 --- a/appendixa/flex-desc.xml +++ b/appendixa/flex-desc.xml @@ -11,7 +11,7 @@ The Flex package contains the flex program <para> Flex is a tool for generating programs which regognize patterns in text. -Pattern recognition is very useful in many applications. You set up rules +Pattern recognition is very useful in many applications. A user sets up rules what to look for and flex will make a program that looks for those patterns. The reason people use flex is that it is much easier to set up rules for what to look for than to write the actual program that finds diff --git a/appendixa/gcc-desc.xml b/appendixa/gcc-desc.xml index cff8315fe..0e971cd34 100644 --- a/appendixa/gcc-desc.xml +++ b/appendixa/gcc-desc.xml @@ -25,9 +25,10 @@ of these compiler generated object files. <para> A pre-processor pre-processes a source file, such as including -the contents of header files into the source file. You generally don't -do this yourself to save yourself a lot of time. You just insert a line -like #include <filename>. The pre-processor file insert the +the contents of header files into the source file. It's a good idea to +not +do this manually to save a lot of time. Someone just inserts a line +like #include <filename>. The pre-processor inserts the contents of that file into the source file. That's one of the things a pre-processor does. </para> |