git: 626265b508 - main - Add colophon and glossary to the handbook.

[Sergio Carlavilla Delgado]

The branch main has been updated by carlavilla:

URL: https://cgit.FreeBSD.org/doc/commit/?id=626265b5086749036ffbcc68ff6207ad684b2501

commit 626265b5086749036ffbcc68ff6207ad684b2501
Author:     Sergio Carlavilla Delgado <carlavilla at FreeBSD.org>
AuthorDate: 2021-03-29 20:59:02 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla at FreeBSD.org>
CommitDate: 2021-03-29 20:59:24 +0000

    Add colophon and glossary to the handbook.
---
 .../content/en/books/handbook/colophon.adoc        |   20 +
 .../content/en/books/handbook/glossary.adoc        | 1042 ++++++++++++++++++++
 .../content/en/books/handbook/pgpkeys/_index.adoc  |    2 +-
 3 files changed, 1063 insertions(+), 1 deletion(-)

diff --git a/documentation/content/en/books/handbook/colophon.adoc b/documentation/content/en/books/handbook/colophon.adoc
new file mode 100644
index 0000000000..95fad7eb4b
--- /dev/null
+++ b/documentation/content/en/books/handbook/colophon.adoc
@@ -0,0 +1,20 @@
+---
+title: Colophon
+prev: books/handbook/glossary
+---
+
+[colophon]
+[[colophon]]
+= Colophon
+:doctype: book
+:icons: font
+:!sectnums:
+:source-highlighter: rouge
+:experimental:
+:skip-front-matter:
+:xrefstyle: basic
+:relfileprefix: ../
+:outfilesuffix:
+
+This book is the combined work of hundreds of contributors to "The FreeBSD Documentation Project".
+The text is authored in AsciiDoc.
diff --git a/documentation/content/en/books/handbook/glossary.adoc b/documentation/content/en/books/handbook/glossary.adoc
new file mode 100644
index 0000000000..20b6323a1c
--- /dev/null
+++ b/documentation/content/en/books/handbook/glossary.adoc
@@ -0,0 +1,1042 @@
+---
+title: FreeBSD Glossary
+prev: books/handbook/pgpkeys
+next: books/handbook/colophon
+---
+
+[glossary]
+[[freebsd-glossary]]
+= FreeBSD Glossary
+:doctype: book
+:icons: font
+:!sectnums:
+:source-highlighter: rouge
+:experimental:
+:skip-front-matter:
+:xrefstyle: basic
+:relfileprefix: ../
+:outfilesuffix:
+
+include::shared/en/urls.adoc[]
+
+This glossary contains terms and acronyms used within the FreeBSD community and documentation.
+
+[discrete]
+== A
+
+ACL::
+See <<acl-glossary,Access Control List>>.
+
+ACPI::
+See <<acpi-glossary,Advanced Configuration and Power Interface>>.
+
+AMD::
+See <<amd-glossary,Automatic Mount Daemon>>.
+
+AML::
+See <<aml-glossary,ACPI Machine Language>>.
+
+API::
+See <<api-glossary,Application Programming Interface>>.
+
+APIC::
+See <<apic-glossary,Advanced Programmable Interrupt Controller>>.
+
+APM::
+See <<apm-glossary,Advanced Power Management>>.
+
+APOP::
+See <<apop-glossary,Authenticated Post Office Protocol>>.
+
+ASL::
+See <<asl-glossary,ACPI Source Language>>.
+
+ATA::
+See <<ata-glossary,Advanced Technology Attachment>>.
+
+ATM::
+See <<atm-glossary,Asynchronous Transfer Mode>>.
+
+[[aml-glossary]]
+ACPI Machine Language::
+Pseudocode, interpreted by a virtual machine within an ACPI-compliant operating system, providing a layer between the underlying hardware and the documented interface presented to the OS.
+
+[[asl-glossary]]
+ACPI Source Language::
+The programming language AML is written in.
+
+[[acl-glossary]]
+Access Control List::
+A list of permissions attached to an object, usually either a file or a network device.
+
+[[acpi-glossary]]
+Advanced Configuration and Power Interface::
+A specification which provides an abstraction of the interface the hardware presents to the operating system, so that the operating system should need to know nothing about the underlying hardware to make the most of it.
+ACPI evolves and supersedes the functionality provided previously by APM, PNPBIOS and other technologies, and provides facilities for controlling power consumption, machine suspension, device enabling and disabling, etc.
+
+[[api-glossary]]
+Application Programming Interface::
+A set of procedures, protocols and tools that specify the canonical interaction of one or more program parts;
+how, when and why they do work together, and what data they share or operate on.
+
+[[apm-glossary]]
+Advanced Power Management::
+An API enabling the operating system to work in conjunction with the BIOS in order to achieve power management.
+APM has been superseded by the much more generic and powerful ACPI specification for most applications.
+
+[[apic-glossary]]
+Advanced Programmable Interrupt Controller::
+{empty}
+
+[[ata-glossary]]
+Advanced Technology Attachment::
+{empty}
+
+[[atm-glossary]]
+Asynchronous Transfer Mode::
+{empty}
+
+[[apop-glossary]]
+Authenticated Post Office Protocol::
+{empty}
+
+[[amd-glossary]]
+Automatic Mount Daemon::
+A daemon that automatically mounts a filesystem when a file or directory within that filesystem is accessed.
+
+[discrete]
+== B
+
+BAR::
+See <<bar-glossary,Base Address Register>>.
+
+BIND::
+See <<bind-glossary,Berkeley Internet Name Domain>>.
+
+BIOS::
+See <<bios-glossary,Basic Input/Output System>>.
+
+BSD::
+See <<bsd-glossary,Berkeley Software Distribution>>.
+
+[[bar-glossary]]
+Base Address Register::
+The registers that determine which address range a PCI device will respond to.
+
+[[bios-glossary]]
+Basic Input/Output System::
+The definition of BIOS depends a bit on the context.
+Some people refer to it as the ROM chip with a basic set of routines to provide an interface between software and hardware.
+Others refer to it as the set of routines contained in the chip that help in bootstrapping the system.
+Some might also refer to it as the screen used to configure the bootstrapping process.
+The BIOS is PC-specific but other systems have something similar.
+
+[[bind-glossary]]
+Berkeley Internet Name Domain::
+An implementation of the DNS protocols.
+
+[[bsd-glossary]]
+Berkeley Software Distribution::
+This is the name that the Computer Systems Research Group (CSRG) at link:http://www.berkeley.edu[The University of California at Berkeley] gave to their improvements and modifications to AT&T's 32V UNIX(R).
+FreeBSD is a descendant of the CSRG work.
+
+[[bikeshed-glossary]]
+Bikeshed Building::
+A phenomenon whereby many people will give an opinion on an uncomplicated topic, whilst a complex topic receives little or no discussion.
+See the link:{faq}#bikeshed-painting[FAQ] for the origin of the term.
+
+[discrete]
+== C
+
+CD::
+See <<cd-glossary,Carrier Detect>>.
+
+CHAP::
+See <<chap-glossary,Challenge Handshake Authentication Protocol>>.
+
+CLIP::
+See <<clip-glossary,Classical IP over ATM>>.
+
+COFF::
+See <<coff-glossary,Common Object File Format>>.
+
+CPU::
+See <<cpu-glossary,Central Processing Unit>>.
+
+CTS::
+See <<cts-glossary,Clear To Send>>.
+
+[[cd-glossary]]
+Carrier Detect::
+An RS232C signal indicating that a carrier has been detected.
+
+[[cpu-glossary]]
+Central Processing Unit::
+Also known as the processor.
+This is the brain of the computer where all calculations take place.
+There are a number of different architectures with different instruction sets.
+Among the more well-known are the Intel-x86 and derivatives, Arm, and PowerPC.
+
+[[chap-glossary]]
+Challenge Handshake Authentication Protocol::
+A method of authenticating a user, based on a secret shared between client and server.
+
+[[clip-glossary]]
+Classical IP over ATM::
+{empty}
+
+[[cts-glossary]]
+Clear To Send::
+An RS232C signal giving the remote system permission to send data.
++
+See <<rts-glossary,Also Request To Send>>.
+
+[[coff-glossary]]
+Common Object File Format::
+{empty}
+
+[discrete]
+== D
+
+DAC::
+See <<dac-glossary,Discretionary Access Control>>.
+
+DDB::
+See <<ddb-glossary,Debugger>>.
+
+DES::
+See <<des-glossary,Data Encryption Standard>>.
+
+DHCP::
+See <<dhcp-glossary,Dynamic Host Configuration Protocol>>.
+
+DNS::
+See <<dns-glossary,Domain Name System>>.
+
+DSDT::
+See <<dsdt-glossary,Differentiated System Description Table>>.
+
+DSR::
+See <<dsr-glossary,Data Set Ready>>.
+
+DTR::
+See <<dtr-glossary,Data Terminal Ready>>.
+
+DVMRP::
+See <<dvmrp-glossary,Distance-Vector Multicast Routing Protocol>>.
+
+[[dac-glossary]]
+Discretionary Access Control::
+{empty}
+
+[[des-glossary]]
+Data Encryption Standard::
+A method of encrypting information, traditionally used as the method of encryption for UNIX(R) passwords and the man:crypt[3] function.
+
+[[dsr-glossary]]
+Data Set Ready::
+An RS232C signal sent from the modem to the computer or terminal indicating a readiness to send and receive data.
++
+See <<dtr-glossary,Also Data Terminal Ready>>.
+
+[[dtr-glossary]]
+Data Terminal Ready::
+An RS232C signal sent from the computer or terminal to the modem indicating a readiness to send and receive data.
+
+[[ddb-glossary]]
+Debugger::
+An interactive in-kernel facility for examining the status of a system, often used after a system has crashed to establish the events surrounding the failure.
+
+[[dsdt-glossary]]
+Differentiated System Description Table::
+An ACPI table, supplying basic configuration information about the base system.
+
+[[dvmrp-glossary]]
+Distance-Vector Multicast Routing Protocol::
+{empty}
+
+[[dns-glossary]]
+Domain Name System::
+The system that converts humanly readable hostnames (i.e., mail.example.net) to Internet addresses and vice versa.
+
+[[dhcp-glossary]]
+Dynamic Host Configuration Protocol::
+A protocol that dynamically assigns IP addresses to a computer (host) when it requests one from the server.
+The address assignment is called a “lease”.
+
+[discrete]
+== E
+
+ECOFF::
+See <<ecoff-glossary,Extended COFF>>.
+
+ELF::
+See <<elf-glossary,Executable and Linking Format>>.
+
+ESP::
+See <<esp-glossary,Encapsulated Security Payload>>.
+
+Encapsulated Security Payload::
+{empty}
+
+[[elf-glossary]]
+Executable and Linking Format::
+{empty}
+
+[[ecoff-glossary]]
+Extended COFF::
+{empty}
+
+[discrete]
+== F
+
+FADT::
+See <<fadt-glossary,Fixed ACPI Description Table>>.
+
+FAT::
+See <<fat-glossary,File Allocation Table>>.
+
+FAT16::
+See <<fat16-glossary,File Allocation Table (16-bit)>>.
+
+FTP::
+See <<ftp-glossary,File Transfer Protocol>>.
+
+[[fat-glossary]]
+File Allocation Table::
+{empty}
+
+[[fat16-glossary]]
+File Allocation Table (16-bit)::
+{empty}
+
+[[ftp-glossary]]
+File Transfer Protocol::
+A member of the family of high-level protocols implemented on top of TCP which can be used to transfer files over a TCP/IP network.
+
+[[fadt-glossary]]
+Fixed ACPI Description Table::
+{empty}
+
+[discrete]
+== G
+
+GUI::
+See <<gui-glossary,Graphical User Interface>>.
+
+[[giant-glossary]]
+Giant::
+The name of a mutual exclusion mechanism (a sleep `mutex`) that protects a large set of kernel resources.
+Although a simple locking mechanism was adequate in the days where a machine might have only a few dozen processes, one networking card, and certainly only one processor, in current times it is an unacceptable performance bottleneck.
+FreeBSD developers are actively working to replace it with locks that protect individual resources, which will allow a much greater degree of parallelism for both single-processor and multi-processor machines.
+
+[[gui-glossary]]
+Graphical User Interface::
+A system where the user and computer interact with graphics.
+
+[discrete]
+== H
+
+HTML::
+See <<html-glossary,HyperText Markup Language>>.
+
+HUP::
+See <<hup-glossary,HangUp>>.
+
+[[hup-glossary]]
+HangUp::
+{empty}
+
+[[html-glossary]]
+HyperText Markup Language::
+The markup language used to create web pages.
+
+[discrete]
+== I
+
+I/O::
+See <<io-glossary,Input/Output>>.
+
+IASL::
+See <<iasl-glossary,Intel’s ASL compiler>>.
+
+IMAP::
+See <<imap-glossary,Internet Message Access Protocol>>.
+
+IP::
+See <<ip-glossary,Internet Protocol>>.
+
+IPFW::
+See <<ipfw-glossary,IP Firewall>>.
+
+IPP::
+See <<ipp-glossary,Internet Printing Protocol>>.
+
+IPv4::
+See <<ipv4-glossary,IP Version 4>>.
+
+IPv6::
+See <<ipv6-glossary,IP Version 6>>.
+
+ISP::
+See <<isp-glossary,Internet Service Provider>>.
+
+[[ipfw-glossary]]
+IP Firewall::
+{empty}
+
+[[ipv4-glossary]]
+IP Version 4::
+The IP protocol version 4, which uses 32 bits for addressing.
+This version is still the most widely used, but it is slowly being replaced with IPv6.
++
+See <<ipv6-glossary,Also IP Version 6>>.
+
+[[ipv6-glossary]]
+IP Version 6::
+The new IP protocol.
+Invented because the address space in IPv4 is running out.
+Uses 128 bits for addressing.
+
+[[io-glossary]]
+Input/Output::
+{empty}
+
+[[iasl-glossary]]
+Intel’s ASL compiler::
+Intel’s compiler for converting ASL into AML.
+
+[[imap-glossary]]
+Internet Message Access Protocol::
+A protocol for accessing email messages on a mail server, characterised by the messages usually being kept on the server as opposed to being downloaded to the mail reader client.
++
+See Also Post Office Protocol Version 3.
+
+[[ipp-glossary]]
+Internet Printing Protocol::
+{empty}
+
+[[ip-glossary]]
+Internet Protocol::
+The packet transmitting protocol that is the basic protocol on the Internet.
+Originally developed at the U.S. Department of Defense and an extremely important part of the TCP/IP stack.
+Without the Internet Protocol, the Internet would not have become what it is today.
+For more information, see link:ftp://ftp.rfc-editor.org/in-notes/rfc791.txt[RFC 791].
+
+[[isp-glossary]]
+Internet Service Provider::
+A company that provides access to the Internet.
+
+[discrete]
+== K
+
+[[kame-glossary]]
+KAME::
+Japanese for “turtle”, the term KAME is used in computing circles to refer to the link:http://www.kame.net/[KAME Project], who work on an implementation of IPv6.
+
+KDC::
+See <<kdc-glossary,Key Distribution Center>>.
+
+KLD::
+See <<kld-glossary,Kernel ld(1)>>.
+
+KSE::
+See <<kse-glossary,Kernel Scheduler Entities>>.
+
+KVA::
+See <<kva-glossary,Kernel Virtual Address>>.
+
+Kbps::
+See <<kbps-glossary,Kilo Bits Per Second>>.
+
+[[kld-glossary]]
+Kernel man:ld[1]::
+A method of dynamically loading functionality into a FreeBSD kernel without rebooting the system.
+
+[[kse-glossary]]
+Kernel Scheduler Entities::
+A kernel-supported threading system.
+See the link:http://www.freebsd.org/kse[project home page] for further details.
+
+[[kva-glossary]]
+Kernel Virtual Address::
+{empty}
+
+[[kdc-glossary]]
+Key Distribution Center::
+{empty}
+
+[[kbps-glossary]]
+Kilo Bits Per Second::
+Used to measure bandwidth (how much data can pass a given point at a specified amount of time).
+Alternates to the Kilo prefix include Mega, Giga, Tera, and so forth.
+
+[discrete]
+== L
+
+LAN::
+See <<lan-glossary,Local Area Network>>.
+
+LOR::
+See <<lor-glossary,Lock Order Reversal>>.
+
+LPD::
+See <<lpd-glossary,Line Printer Daemon>>.
+
+[[lpd-glossary]]
+Line Printer Daemon::
+{empty}
+
+[[lan-glossary]]
+Local Area Network::
+A network used on a local area, e.g. office, home, or so forth.
+
+[[lor-glossary]]
+Lock Order Reversal::
+The FreeBSD kernel uses a number of resource locks to arbitrate contention for those resources.
+A run-time lock diagnostic system found in FreeBSD-CURRENT kernels (but removed for releases), called man:witness[4], detects the potential for deadlocks due to locking errors.
+(man:witness[4] is actually slightly conservative, so it is possible to get false positives.)
+A true positive report indicates that “if you were unlucky, a deadlock would have happened here”.
++
+True positive LORs tend to get fixed quickly, so check http://lists.FreeBSD.org/mailman/listinfo/freebsd-current and the link:http://sources.zabbadoz.net/freebsd/lor.html[LORs Seen] page before posting to the mailing lists.
+
+[discrete]
+== M
+
+MAC::
+See <<mac-glossary,Mandatory Access Control>>.
+
+MADT::
+See <<madt-glossary,Multiple APIC Description Table>>.
+
+MFC::
+See <<mfc-glossary,Merge From Current>>.
+
+MFH::
+See <<mfh-glossary,Merge From Head>>.
+
+MFS::
+See <<mfs-glossary,Merge From Stable>>.
+
+MFV::
+See <<mfv-glossary,Merge From Vendor>>.
+
+MIT::
+See <<mit-glossary,Massachusetts Institute of Technology>>.
+
+MLS::
+See <<mls-glossary,Multi-Level Security>>.
+
+MOTD::
+See <<motd-glossary,Message Of The Day>>.
+
+MTA::
+See <<mta-glossary,Mail Transfer Agent>>.
+
+MUA::
+See <<mua-glossary,Mail User Agent>>.
+
+[[mta-glossary]]
+Mail Transfer Agent::
+An application used to transfer email.
+An MTA has traditionally been part of the BSD base system.
+Today Sendmail is included in the base system, but there are many other MTAs, such as postfix, qmail and Exim.
+
+[[mua-glossary]]
+Mail User Agent::
+An application used by users to display and write email.
+
+[[mac-glossary]]
+Mandatory Access Control::
+{empty}
+
+[[mit-glossary]]
+Massachusetts Institute of Technology::
+{empty}
+
+[[mfc-glossary]]
+Merge From Current::
+To merge functionality or a patch from the -CURRENT branch to another, most often -STABLE.
+
+[[mfh-glossary]]
+Merge From Head::
+To merge functionality or a patch from a repository HEAD to an earlier branch.
+
+[[mfs-glossary]]
+Merge From Stable::
+In the normal course of FreeBSD development, a change will be committed to the -CURRENT branch for testing before being merged to -STABLE.
+On rare occasions, a change will go into -STABLE first and then be merged to -CURRENT.
++
+This term is also used when a patch is merged from -STABLE to a security branch.
++
+See <<mfc-glossary,Also Merge From Current>>.
+
+[[mfv-glossary]]
+Merge From Vendor::
+{empty}
+
+[[motd-glossary]]
+Message Of The Day::
+A message, usually shown on login, often used to distribute information to users of the system.
+
+[[mls-glossary]]
+Multi-Level Security::
+{empty}
+
+[[madt-glossary]]
+Multiple APIC Description Table::
+{empty}
+
+[discrete]
+== N
+
+NAT::
+See <<nat-glossary,Network Address Translation>>.
+
+NDISulator::
+See <<projectevil-glossary,Project Evil>>.
+
+NFS::
+See <<nfs-glossary,Network File System>>.
+
+NTFS::
+See <<ntfs-glossary,New Technology File System>>.
+
+NTP::
+See <<ntp-glossary,Network Time Protocol>>.
+
+[[nat-glossary]]
+Network Address Translation::
+A technique where IP packets are rewritten on the way through a gateway, enabling many machines behind the gateway to effectively share a single IP address.
+
+[[nfs-glossary]]
+Network File System::
+{empty}
+
+[[ntfs-glossary]]
+New Technology File System::
+A filesystem developed by Microsoft and available in its “New Technology” operating systems, such as Windows(R) 2000, Windows NT(R) and Windows(R) XP.
+
+[[ntp-glossary]]
+Network Time Protocol::
+A means of synchronizing clocks over a network.
+
+[discrete]
+== O
+
+OBE::
+See <<obe-glossary,Overtaken By Events>>.
+
+ODMR::
+See <<odmr-glossary,On-Demand Mail Relay>>.
+
+OS::
+See <<os-glossary,Operating System>>.
+
+[[odmr-glossary]]
+On-Demand Mail Relay::
+{empty}
+
+[[os-glossary]]
+Operating System::
+A set of programs, libraries and tools that provide access to the hardware resources of a computer.
+Operating systems range today from simplistic designs that support only one program running at a time, accessing only one device to fully multi-user, multi-tasking and multi-process systems that can serve thousands of users simultaneously, each of them running dozens of different applications.
+
+[[obe-glossary]]
+Overtaken By Events::
+Indicates a suggested change (such as a Problem Report or a feature request) which is no longer relevant or applicable due to such things as later changes to FreeBSD, changes in networking standards, the affected hardware having since become obsolete, and so forth.
+
+[discrete]
+== P
+
+PAE::
+See <<pae-glossary,Physical Address Extensions>>.
+
+PAM::
+See <<pam-glossary,Pluggable Authentication Modules>>.
+
+PAP::
+See <<pap-glossary,Password Authentication Protocol>>.
+
+PC::
+See <<pc-glossary,Personal Computer>>.
+
+PCNSFD::
+See <<pcnfsd-glossary,Personal Computer Network File System Daemon>>.
+
+PDF::
+See <<pdf-glossary,Portable Document Format>>.
+
+PID::
+See <<pid-glossary,Process ID>>.
+
+POLA::
+See <<pola-glossary,Principle Of Least Astonishment>>.
+
+POP::
+See <<pop-glossary,Post Office Protocol>>.
+
+POP3::
+See <<pop3-glossary,Post Office Protocol Version 3>>.
+
+PPD::
+See <<ppd-glossary,PostScript Printer Description>>.
+
+PPP::
+See <<ppp-glossary,Point-to-Point Protocol>>.
+
+PPPoA::
+See <<pppoa-glossary,PPP over ATM>>.
+
+PPPoE::
+See <<pppoe-glossary,PPP over Ethernet>>.
+
+[[pppoa-glossary]]
+PPP over ATM::
+{empty}
+
+[[pppoe-glossary]]
+PPP over Ethernet::
+{empty}
+
+PR::
+See <<pr-glossary,Problem Report>>.
+
+PXE::
+See <<pxe-glossary,Preboot eXecution Environment>>.
+
+[[pap-glossary]]
+Password Authentication Protocol::
+{empty}
+
+[[pc-glossary]]
+Personal Computer::
+{empty}
+
+[[pcnfsd-glossary]]
+Personal Computer Network File System Daemon::
+{empty}
+
+[[pae-glossary]]
+Physical Address Extensions::
+A method of enabling access to up to 64 GB of RAM on systems which only physically have a 32-bit wide address space (and would therefore be limited to 4 GB without PAE).
+
+[[pam-glossary]]
+Pluggable Authentication Modules::
+{empty}
+
+[[ppp-glossary]]
+Point-to-Point Protocol::
+{empty}
+
+[[pointyhat]]
+Pointy Hat::
+A mythical piece of headgear, much like a dunce cap, awarded to any FreeBSD committer who breaks the build, makes revision numbers go backwards, or creates any other kind of havoc in the source base.
+Any committer worth his or her salt will soon accumulate a large collection.
+The usage is (almost always?) humorous.
+
+[[pdf-glossary]]
+Portable Document Format::
+{empty}
+
+[[pop-glossary]]
+Post Office Protocol::
+See Also Post Office Protocol Version 3.
+
+[[pop3-glossary]]
+Post Office Protocol Version 3::
+A protocol for accessing email messages on a mail server, characterised by the messages usually being downloaded from the server to the client, as opposed to remaining on the server.
++
+See <<imap-glossary,Also Internet Message Access Protocol>>.
+
+[[ppd-glossary]]
+PostScript Printer Description::
+{empty}
+
+[[pxe-glossary]]
+Preboot eXecution Environment::
+{empty}
+
+[[pola-glossary]]
+Principle Of Least Astonishment::
+As FreeBSD evolves, changes visible to the user should be kept as unsurprising as possible.
+For example, arbitrarily rearranging system startup variables in [.filename]#/etc/defaults/rc.conf# violates POLA.
+Developers consider POLA when contemplating user-visible system changes.
+
+[[pr-glossary]]
+Problem Report::
+A description of some kind of problem that has been found in either the FreeBSD source or documentation.
+See link:{problem-reports}[Writing FreeBSD Problem Reports].
+
+[[pid-glossary]]
+Process ID::
+A number, unique to a particular process on a system, which identifies it and allows actions to be taken against it.
+
+[[projectevil-glossary]]
+Project Evil::
+The working title for the NDISulator, written by Bill Paul, who named it referring to how awful it is (from a philosophical standpoint) to need to have something like this in the first place.
+The NDISulator is a special compatibility module to allow Microsoft Windows(TM) NDIS miniport network drivers to be used with FreeBSD/i386.
+This is usually the only way to use cards where the driver is closed-source.
+See [.filename]#src/sys/compat/ndis/subr_ndis.c#.
+
+[discrete]
+== R
+
+RA::
+See <<ra-glossary,Router Advertisement>>.
+
+RAID::
+See <<raid-glossary,Redundant Array of Inexpensive Disks>>.
+
+RAM::
+See <<ram-glossary,Random Access Memory>>.
+
+RD::
+See <<rd-glossary,Received Data>>.
+
+RFC::
+See <<rfc-glossary,Request For Comments>>.
+
+RISC::
+See <<risc-glossary,Reduced Instruction Set Computer>>.
+
+RPC::
+See <<rpc-glossary,Remote Procedure Call>>.
+
+RS232C::
+See <<rs232c-glossary,Recommended Standard 232C>>.
+
+RTS::
+See <<rts-glossary,Request To Send>>.
+
+[[ram-glossary]]
+Random Access Memory::
+{empty}
+
+[[rcs-glossary]]
+Revision Control System::
+The _Revision Control System (RCS)_ is one of the oldest software suites that implement “revision control” for plain files.
+It allows the storage, retrieval, archival, logging, identification and merging of multiple revisions for each file.
+RCS consists of many small tools that work together.
+It lacks some of the features found in more modern revision control systems, like Git, but it is very simple to install, configure, and start using for a small set of files.
++
+See <<svn-glossary,Also Subversion>>.
+
+[[rd-glossary]]
+Received Data::
+An RS232C pin or wire that data is received on.
++
+See <<td-glossary,Also Transmitted Data>>.
+
+[[rs232c-glossary]]
+Recommended Standard 232C::
+A standard for communications between serial devices.
+
+[[risc-glossary]]
+Reduced Instruction Set Computer::
+An approach to processor design where the operations the hardware can perform are simplified but made as general purpose as possible.
+This can lead to lower power consumption, fewer transistors and in some cases, better performance and increased code density.
+Examples of RISC processors include the Alpha, SPARC(R), ARM(R) and PowerPC(R).
+
+[[raid-glossary]]
+Redundant Array of Inexpensive Disks::
+{empty}
+
+[[rpc-glossary]]
+Remote Procedure Call::
+{empty}
+
+[[rfc-glossary]]
+Request For Comments::
+A set of documents defining Internet standards, protocols, and so forth.
+See www.rfc-editor.org.
++
+Also used as a general term when someone has a suggested change and wants feedback.
+
+[[rts-glossary]]
+Request To Send::
+An RS232C signal requesting that the remote system commences transmission of data.
++
+See <<cts-glossary,Also Clear To Send>>.
+
+[[ra-glossary]]
+Router Advertisement::
+{empty}
+
+[discrete]
+== S
+
+SCI::
+See <<sci-glossary,System Control Interrupt>>.
+
+SCSI::
+See <<scsi-glossary,Small Computer System Interface>>.
+
+SG::
+See <<sg-glossary,Signal Ground>>.
+
+SMB::
+See <<smb-glossary,Server Message Block>>.
+
+SMP::
+See <<smp-glossary,Symmetric MultiProcessor>>.
+
+SMTP::
+See <<smtp-glossary,Simple Mail Transfer Protocol>>.
+
+SMTP AUTH::
+See <<smtpauth-glossary,SMTP Authentication>>.
+
+SSH::
+See <<ssh-glossary,Secure Shell>>.
+
+STR::
+See <<str-glossary,Suspend To RAM>>.
+
+SVN::
+See <<svn-glossary,Subversion>>.
+
+[[smtpauth-glossary]]
+SMTP Authentication::
+{empty}
+
+[[smb-glossary]]
+Server Message Block::
+{empty}
+
+[[sg-glossary]]
+Signal Ground::
+An RS232 pin or wire that is the ground reference for the signal.
+
+[[smtp-glossary]]
+Simple Mail Transfer Protocol::
+{empty}
+
+[[ssh-glossary]]
+Secure Shell::
+{empty}
+
+[[scsi-glossary]]
+Small Computer System Interface::
+{empty}
+
+[[svn-glossary]]
+Subversion::
+Subversion is a version control system currently used by the FreeBSD project.
+
+[[str-glossary]]
+Suspend To RAM::
+{empty}
+
+[[smp-glossary]]
+Symmetric MultiProcessor::
+{empty}
+
+[[sci-glossary]]
+System Control Interrupt::
+{empty}
+
*** 117 LINES SKIPPED ***