diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/e.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/e.adoc index 3628a84e..d9058047 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/e.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/e.adoc @@ -1,13 +1,13 @@ [discrete] [[emacs]] ==== image:images/yes.png[yes] Emacs (noun) -*Description*: "Emacs" is a text editor available in Unix. Like vi, Emacs is a screen editor. Unlike vi, Emacs is not an insertion mode editor, meaning that any character typed in Emacs is automatically inserted into the file, unless it includes a command prefix. +*Description*: "Emacs" is a text editor that is available on the UNIX system and similar operating systems. Like vi, Emacs is a screen editor. Unlike vi, Emacs is not an insertion mode editor, meaning that any character typed in Emacs is automatically inserted into the file, unless it includes a command prefix. If referring to the program, use "Emacs," for example, "Source-Navigator supports Emacs or vi commands." If referring to the shell prompt command, use `emacs`. Always mark up the command correctly, for example, "At the prompt, type `emacs`." The complete and correct name is "GNU Emacs." *Use it*: yes -*Incorrect forms*: +*Incorrect forms*: *See also*: @@ -29,7 +29,7 @@ If referring to the program, use "Emacs," for example, "Source-Navigator support *Use it*: yes -*Incorrect forms*: +*Incorrect forms*: *See also*: xref:return[return] @@ -40,20 +40,20 @@ If referring to the program, use "Emacs," for example, "Source-Navigator support *Use it*: with caution -*Incorrect forms*: +*Incorrect forms*: *See also*: xref:subscription[subscription], xref:repository[repository] [discrete] [[environment]] ==== image:images/yes.png[yes] environment (noun) -*Description*: In IT, "environment" refers to the state of a computer, usually determined by which programs are running and basic hardware and software characteristics. For example, when one speaks of running a program in a Unix "environment," it means running a program on a computer that has the Unix operating system. One ingredient of an environment is the operating system, but operating systems include a number of different parameters. For example, many operating systems allow you to choose your command prompt or a default command path. All these parameters taken together comprise the environment. +*Description*: In IT, "environment" refers to the state of a computer, usually determined by which programs are running and basic hardware and software characteristics. For example, when one speaks of running a program in a UNIX "environment," it means running a program on a computer that has the UNIX operating system. One ingredient of an environment is the operating system, but operating systems include a number of different parameters. For example, many operating systems allow you to choose your command prompt or a default command path. All these parameters taken together comprise the environment. *Use it*: yes -*Incorrect forms*: +*Incorrect forms*: -*See also*: +*See also*: [discrete] [[essentially]] @@ -62,9 +62,9 @@ If referring to the program, use "Emacs," for example, "Source-Navigator support *Use it*: no -*Incorrect forms*: +*Incorrect forms*: -*See also*: +*See also*: [discrete] [[event]] @@ -73,7 +73,7 @@ If referring to the program, use "Emacs," for example, "Source-Navigator support *Use it*: yes -*Incorrect forms*: +*Incorrect forms*: *See also*: @@ -95,7 +95,7 @@ If referring to the program, use "Emacs," for example, "Source-Navigator support *Use it*: yes -*Incorrect forms*: +*Incorrect forms*: *See also*: @@ -108,14 +108,14 @@ If referring to the program, use "Emacs," for example, "Source-Navigator support *Incorrect forms*: EXIF, exif -*See also*: +*See also*: [discrete] [[extranet]] ==== image:images/yes.png[yes] extranet (noun) *Description*: "Extranet" refers to an "intranet" that is partially accessible to authorized outsiders. Whereas an intranet resides behind a firewall and is accessible only to people who are members of the same company or organization, an extranet provides various levels of accessibility to outsiders. You can access an extranet only if you have a valid user name and password. Your identity determines which parts of the extranet you can view. -Capitalize "extranet" only at the beginning of a sentence. +Capitalize "extranet" only at the beginning of a sentence. *Use it*: yes diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/g.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/g.adoc index 1a906e93..d9f7cc94 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/g.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/g.adoc @@ -112,7 +112,7 @@ [discrete] [[gdb]] ==== image:images/yes.png[yes] GDB (noun) -*Description*: "GDB" is an acronym for "GNU Debugger," the standard debugger for the GNU operating system. It is a portable debugger that runs on many Unix-like systems and works for many programming languages. When referring to the program, use "GDB." +*Description*: "GDB" is an acronym for "GNU Debugger," the standard debugger for the GNU operating system. It is a portable debugger that runs on many operating systems that are similar to the UNIX system, and works for many programming languages. When referring to the program, use "GDB." *Use it*: yes @@ -123,7 +123,7 @@ [discrete] [[gdb-command]] ==== image:images/yes.png[yes] gdb (noun) -*Description*: "GDB" is an acronym for "GNU Debugger," the standard debugger for the GNU operating system. It is a portable debugger that runs on many Unix-like systems and works for many programming languages. When referring to the command, use `gdb`, marked up appropriately. +*Description*: "GDB" is an acronym for "GNU Debugger," the standard debugger for the GNU operating system. It is a portable debugger that runs on many operating systems that are similar to the UNIX system, and works for many programming languages. When referring to the command, use `gdb`, marked up appropriately. *Use it*: yes @@ -178,7 +178,7 @@ [discrete] [[gnome]] ==== image:images/yes.png[yes] GNOME (noun) -*Description*: "GNOME" is an open source desktop environment for Unix systems. +*Description*: "GNOME" is an open source desktop environment for operating systems that are similar to the UNIX system. *Use it*: yes @@ -200,7 +200,7 @@ [discrete] [[gnu]] ==== image:images/yes.png[yes] GNU (noun) -*Description*: "GNU" is a recursive acronym for "GNU's Not Unix." GNU is a Unix-like, open-source operating system. Do not use "Gnu" or "gnu." +*Description*: "GNU" is a recursive acronym for "GNU's Not UNIX." GNU is an open-source operating system that is similar to the UNIX system. Do not use "Gnu" or "gnu." *Use it*: yes diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/j.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/j.adoc index 3dd572de..5dbfe982 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/j.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/j.adoc @@ -57,7 +57,7 @@ [discrete] [[jsvc]] ==== image:images/yes.png[yes] jsvc (noun) -*Description*: The Apache Commons Daemon "jsvc" is a set of libraries and applications for making Java applications run on Unix more easily. Capitalize the initial "J" only at the beginning of a sentence. +*Description*: The Apache Commons Daemon "jsvc" is a set of libraries and applications for making Java applications run on UNIX systems more easily. Capitalize the initial "J" only at the beginning of a sentence. *Use it*: yes diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/l.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/l.adoc index d1407c02..bdf11da1 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/l.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/l.adoc @@ -36,7 +36,7 @@ [discrete] [[linux]] ==== image:images/yes.png[yes] Linux (noun) -*Description*: "Linux" is a Unix-like operating system. Do not use "LINUX" because it is not an acronym. Do not use "linux" unless you are referring to a command, such as "To start Linux, type `linux`." In that case, mark it correctly. +*Description*: "Linux" is an operating system that is similar to the UNIX system. Do not use "LINUX" because it is not an acronym. Do not use "linux" unless you are referring to a command, such as "To start Linux, type `linux`." In that case, mark it correctly. *Use it*: yes diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/p.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/p.adoc index 9658e20a..e8e48f3c 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/p.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/p.adoc @@ -111,7 +111,7 @@ [discrete] [[posix]] ==== image:images/yes.png[yes] POSIX (noun) -*Description*: "POSIX" is an acronym for "Portable Operating System Interface [for Unix]." +*Description*: "POSIX" is an acronym for "Portable Operating System Interface [for UNIX]." *Use it*: yes diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/r.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/r.adoc index 7b5a213e..a0b34deb 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/r.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/r.adoc @@ -23,7 +23,7 @@ [discrete] [[raw]] ==== image:images/yes.png[yes] raw (adjective) -*Description*: In computing terms, "raw" means unprocessed. The term refers to data that is passed to an I/O device without being interpreted. In contrast, "cooked" refers to data that is processed before being passed to the I/O device. The term comes from Unix, which supports cooked and raw modes for data output to a terminal. In cooked mode, special characters, such as erase and kill, are processed by the device driver before being sent to the output device. +*Description*: In computing terms, "raw" means unprocessed. The term refers to data that is passed to an I/O device without being interpreted. In contrast, "cooked" refers to data that is processed before being passed to the I/O device. The term comes from the UNIX system, which supports cooked and raw modes for data output to a terminal. In cooked mode, special characters, such as erase and kill, are processed by the device driver before being sent to the output device. *Use it*: yes @@ -335,7 +335,7 @@ Write this name in full the first time that you use it in a document. Subsequent [discrete] [[runlevel]] ==== image:images/yes.png[yes] runlevel (noun) -*Description*: A "runlevel" is a preset operating state on a Unix-like operating system. A system can be booted in to (that is, started up in to) any of several runlevels, each of which is represented by a single-digit integer. Each runlevel designates a different system configuration and allows access to a different combination of processes (that is, instances of executing programs). There are differences in the runlevels according to the operating system. Seven runlevels are supported in the standard Linux kernel. +*Description*: A "runlevel" is a preset operating state on a UNIX system and similar operating systems. A system can be booted in to (that is, started up in to) any of several runlevels, each of which is represented by a single-digit integer. Each runlevel designates a different system configuration and allows access to a different combination of processes (that is, instances of executing programs). There are differences in the runlevels according to the operating system. Seven runlevels are supported in the standard Linux kernel. *Use it*: yes diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/s.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/s.adoc index 5b0dd8d9..cfdcee13 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/s.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/s.adoc @@ -12,7 +12,7 @@ [discrete] [[samba]] ==== image:images/yes.png[yes] Samba (noun) -*Description*: "Samba" is a freeware program that allows end users to access and use files, printers, and other commonly shared resources on a company's intranet or on the internet. Samba can be installed on a variety of operating system platforms, including Linux, most common Unix platforms, OpenVMS, and OS/2. +*Description*: "Samba" is a freeware program that allows end users to access and use files, printers, and other commonly shared resources on a company's intranet or on the internet. Samba can be installed on a variety of operating system platforms, including Linux, most common UNIX platforms, OpenVMS, and OS/2. *Use it*: yes diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/u.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/u.adoc index 0b840240..dcdac59b 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/u.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/u.adoc @@ -34,11 +34,11 @@ [discrete] [[unix]] ==== image:images/yes.png[yes] UNIX (noun) -*Description*: UNIX is a registered trademark of The Open Group. Do not use "UNIX-like"; use an expression such as "Linux, UNIX, and similar operating systems" instead. +*Description*: UNIX is a registered trademark of The Open Group. Do not use "UNIX-like" or "UNIX-based"; use an expression such as "Linux, UNIX, and similar operating systems" or "UNIX system-based" instead. *Use it*: yes -*Incorrect forms*: Unix, unix, UNIX-like +*Incorrect forms*: Unix, unix, UNIX-like, UNIX-based *See also*: diff --git a/supplementary_style_guide/glossary_terms_conventions/general_conventions/v.adoc b/supplementary_style_guide/glossary_terms_conventions/general_conventions/v.adoc index ec8aff9c..94ad45ac 100644 --- a/supplementary_style_guide/glossary_terms_conventions/general_conventions/v.adoc +++ b/supplementary_style_guide/glossary_terms_conventions/general_conventions/v.adoc @@ -47,7 +47,7 @@ Use lowercase "v" and uppercase "CPU". [discrete] [[vi]] ==== image:images/yes.png[yes] vi (noun) -*Description*: "vi" is a screen-oriented text editor originally created for the Unix operating system. Do not use "VI." +*Description*: "vi" is a screen-oriented text editor originally created for the UNIX operating system. Do not use "VI." *Use it*: yes @@ -69,7 +69,7 @@ Use lowercase "v" and uppercase "CPU". [discrete] [[vim]] ==== image:images/yes.png[yes] Vim (noun) -*Description*: "Vim" is an acronym for Vi IMproved. In the original 1991 release for the Amiga platform, the acronym was derived from Vi IMitation. It became Vi IMproved when ported to various Unix-based operating systems in 1992. Despite being an acronym, and despite the first word of the "About" text that is displayed when you launch the editor, the standard, proper noun-derived, mixed-case spelling has been in use since its release on the Amiga. +*Description*: "Vim" is an acronym for Vi IMproved. In the original 1991 release for the Amiga platform, the acronym was derived from Vi IMitation. It became Vi IMproved in 1992, when ported to the UNIX system and similar operating systems. Despite being an acronym, and despite the first word of the "About" text that is displayed when you launch the editor, the standard, proper noun-derived, mixed-case spelling has been in use since its release on the Amiga. *Use it*: yes