From a00e7d78ad3f93075e55e2871b5bb22c1c685f56 Mon Sep 17 00:00:00 2001 From: Jason Evans Date: Mon, 5 Jan 2015 02:54:43 -0600 Subject: [PATCH 01/10] fixed typo --- LDP/guide/docbook/Bash-Beginners-Guide/chap7.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LDP/guide/docbook/Bash-Beginners-Guide/chap7.xml b/LDP/guide/docbook/Bash-Beginners-Guide/chap7.xml index 932f7db9..7a3a8cc8 100644 --- a/LDP/guide/docbook/Bash-Beginners-Guide/chap7.xml +++ b/LDP/guide/docbook/Bash-Beginners-Guide/chap7.xml @@ -55,7 +55,7 @@ [ FILE1 FILE2 ]True if FILE1 is older than FILE2, or is FILE2 exists and FILE1 does not. [ FILE1 FILE2 ]True if FILE1 and FILE2 refer to the same device and inode numbers. [ OPTIONNAME ]True if shell option OPTIONNAME is enabled. - STRING ]True of the length if STRING is zero. + STRING ]True if the length if STRING is zero. STRING ] or [ STRING ]True if the length of STRING is non-zero. [ STRING1 == STRING2 ] True if the strings are equal. = may be used instead of == for strict POSIX compliance. [ STRING1 != STRING2 ] True if the strings are not equal. From 20b9c958c26cc0089b598917d518f95f4a822258 Mon Sep 17 00:00:00 2001 From: tgeek77 Date: Sat, 16 Jan 2016 20:59:00 +0100 Subject: [PATCH 02/10] Adding Package\ Management\ Basics.xml --- .../Package Management Basics.xml | 532 ++++++++++++++++++ 1 file changed, 532 insertions(+) create mode 100644 LDP/guide/docbook/Package-Management-Basics/Package Management Basics.xml diff --git a/LDP/guide/docbook/Package-Management-Basics/Package Management Basics.xml b/LDP/guide/docbook/Package-Management-Basics/Package Management Basics.xml new file mode 100644 index 00000000..5a6bd455 --- /dev/null +++ b/LDP/guide/docbook/Package-Management-Basics/Package Management Basics.xml @@ -0,0 +1,532 @@ + + + + +
+ +Package Management Basics: apt, yum, dnf, pkg + +Introduction + +Why was this document written? +Most modern Unix-like operating systems offer a centralized mechanism for finding and installing software. Software is usually distributed in the form of;packages, kept in;repositories. Working with packages is known as;package management. Packages provide the basic components of an operating system, along with shared libraries, applications, services, and documentation. +A package management system does much more than one-time installation of software. It also provides tools for upgrading already-installed packages. Package repositories help to ensure that code has been vetted for use on your system, and that the installed versions of software have been approved by developers and package maintainers. +When configuring servers or development environments, it's often necessary look beyond official repositories. Packages in the stable release of a distribution may be out of date, especially where new or rapidly-changing software is concerned. Nevertheless, package management is a vital skill for system administrators and developers, and the wealth of packaged software for major distributions is a tremendous resource. +This guide is intended as a quick reference for the fundamentals of finding, installing, and upgrading packages on a variety of distributions, and should help you translate that knowledge between systems. +Audience +For those new to Linux who need a basic understanding of package management. +Original version of this doc +The original version of this guide can be found at Digital Ocean. +Revision History + + + + + + +15.1.2016 +v1.0 converted and edited for TLDP +Jason Evans + + + +Contributions + +Brennen Bearnes (original author).Jason Evans (editor and maintainer for TLDP) +Feedback +Missing information, missing links, missing characters? Mail it to the maintainer of this document: jsevans at youvegotthe.info +Copyright information +This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. +What do you need? +This guide covers Debian, Ubuntu, CentOS, Fedora, and FreeBSD and will require one of those distributions to be installed +Package Management Systems: A Brief Overview +Most package systems are built around collections of package files. A package file is usually an archive which contains compiled binaries and other resources making up the software, along with installation scripts. Packages also contain valuable metadata, including their;dependencies, a list of other packages required to install and run them. +While their functionality and benefits are broadly similar, packaging formats and tools vary by platform: + + + + + + +Operating System +Format +Tool(s) + + + + +Debian +.deb +apt, apt-cache, apt-get, dpkg + + +Ubuntu +.deb +apt, apt-cache, apt-get, dpkg + + +CentOS +.rpm +yum + + +Fedora +.rpm +dnf + + +FreeBSD +Ports,;.txz +make, pkg + + + +In Debian and systems based on it, like Ubuntu, Linux Mint, and Raspbian, the package format is the;.debfile. APT, the Advanced Packaging Tool, provides commands used for most common operations: Searching repositories, installing collections of packages and their dependencies, and managing upgrades. APT commands operate as a front-end to the lower-level;dpkg;utility, which handles the installation of individual;.deb;files on the local system, and is sometimes invoked directly. +CentOS, Fedora, and other members of the Red Hat family use RPM files. In CentOS,;yum;is used to interact with both individual package files and repositories. +In recent versions of Fedora,;yum;has been supplanted by;dnf, a modernized fork which retains most ofyum's interface. +FreeBSD's binary package system is administered with the;pkg;command. FreeBSD also offers the Ports Collection, a local directory structure and tools which allow the user to fetch, compile, and install packages directly from source using Makefiles. It's usually much more convenient to use;pkg, but occasionally a pre-compiled package is unavailable, or you may need to change compile-time options. +Update Package Lists +Most systems keep a local database of the packages available from remote repositories. It's best to update this database before installing or upgrading packages. As a partial exception to this pattern,;yumand;dnf;will check for updates before performing some operations, but you can ask them at any time whether updates are available. + + + + + +System +Command + + + + +Debian / Ubuntu +sudo apt-get update + + +CentOS +yum check-update + + +Fedora +dnf check-update + + +FreeBSD Packages +sudo pkg update + + +FreeBSD Ports +sudo portsnap fetch update + + + +Upgrade Installed Packages +Making sure that all of the installed software on a machine stays up to date would be an enormous undertaking without a package system. You would have to track upstream changes and security alerts for hundreds of different packages. While a package manager doesn't solve every problem you'll encounter when upgrading software, it does enable you to maintain most system components with a few commands. +On FreeBSD, upgrading installed ports can introduce breaking changes or require manual configuration steps. It's best to read;/usr/ports/UPDATING;before upgrading with;portmaster. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo apt-get upgrade +Only upgrades installed packages, where possible. + + + +sudo apt-get dist-upgrade +May add or remove packages to satisfy new dependencies. + + +CentOS +sudo yum update + + + +Fedora +sudo dnf upgrade + + + +FreeBSD Packages +sudo pkg upgrade + + + +FreeBSD Ports +less /usr/ports/UPDATING +Uses;less;to view update notes for ports (use arrow keys to scroll, pressq;to quit). + + + +cd /usr/ports/ports-mgmt/portmaster && sudo make install && sudo portmaster -a +Installs;portmaster;and uses it to update installed ports. + + + +Find a Package +Most distributions offer a graphical or menu-driven front end to package collections. These can be a good way to browse by category and discover new software. Often, however, the quickest and most effective way to locate a package is to search with command-line tools. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +apt-cache search;search_string + + + +CentOS +yum search;search_string + + + + +yum search all;search_string +Searches all fields, including description. + + +Fedora +dnf search;search_string + + + + +dnf search all;search_string +Searches all fields, including description. + + +FreeBSD Packages +pkg search;search_string +Searches by name. + + + +pkg search -f;search_string +Searches by name, returning full descriptions. + + + +pkg search -D;search_string +Searches description. + + +FreeBSD Ports +cd /usr/ports && make search name=package +Searches by name. + + + +cd /usr/ports && make search key=search_string +Searches comments, descriptions, and dependencies. + + + +View Info About a Specific Package +When deciding what to install, it's often helpful to read detailed descriptions of packages. Along with human-readable text, these often include metadata like version numbers and a list of the package's dependencies. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +apt-cache show;package +Shows locally-cached info about a package. + + + +dpkg -s;package +Shows the current installed status of a package. + + +CentOS +yum info;package + + + + +yum deplist;package +Lists dependencies for a package. + + +Fedora +dnf info;package + + + + +dnf repoquery -\/-requires;package +Lists dependencies for a package. + + +FreeBSD Packages +pkg info;package +Shows info for an installed package. + + +FreeBSD Ports +cd /usr/ports/category/port;&& cat pkg-descr + + + + +Install a Package from Repositories +Once you know the name of a package, you can usually install it and its dependencies with a single command. In general, you can supply multiple packages to install simply by listing them all. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo apt-get install;package + + + + +sudo apt-get install;package1 package2 ... +Installs all listed packages. + + + +sudo apt-get install -y;package +Assumes "yes" where;apt;would usually prompt to continue. + + +CentOS +sudo yum install;package + + + + +sudo yum install;package1 package2 ... +Installs all listed packages. + + + +sudo yum install -y;package +Assumes "yes" where;yum;would usually prompt to continue. + + +Fedora +sudo dnf install;package + + + + +sudo dnf install;package1 package2 ... +Installs all listed packages. + + + +sudo dnf install -y;package +Assumes "yes" where;dnf;would usually prompt to continue. + + +FreeBSD Packages +sudo pkg install;package + + + + +sudo pkg install;package1 package2 ... +Installs all listed packages. + + +FreeBSD Ports +cd /usr/ports/category/port;&& sudo make install +Builds and installs a port from source. + + + +Install a Package from the Local Filesystem +Sometimes, even though software isn't officially packaged for a given operating system, a developer or vendor will offer package files for download. You can usually retrieve these with your web browser, or viacurl;on the command line. Once a package is on the target system, it can often be installed with a single command. +On Debian-derived systems,;dpkg;handles individual package files. If a package has unmet dependencies,;gdebi;can often be used to retrieve them from official repositories. +On CentOS and Fedora systems,;yum;and;dnf;are used to install individual files, and will also handle needed dependencies. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo dpkg -i;package.deb + + + + +sudo apt-get install -ygdebi && sudo gdebipackage.deb +Installs and uses gdebi to install package.deb and retrieve any missing dependencies. + + +CentOS +sudo yum install;package.rpm + + + +Fedora +sudo dnf install;package.rpm + + + +FreeBSD Packages +sudo pkg add;package.txz + + + + +sudo pkg add -f;package.txz +Installs package even if already installed. + + + +Remove One or More Installed Packages +Since a package manager knows what files are provided by a given package, it can usually remove them cleanly from a system if the software is no longer needed. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo apt-get remove;package + + + + +sudo apt-get autoremove +Removes unneeded packages. + + +CentOS +sudo yum remove;package + + + +Fedora +sudo dnf erase;package + + + +FreeBSD Packages +sudo pkg delete;package + + + + +sudo pkg autoremove +Removes unneeded packages. + + +FreeBSD Ports +sudo pkg delete;package + + + + +cd /usr/ports/path_to_port;&& make deinstall +De-installs an installed port. + + + +Get Help +In addition to web-based documentation, keep in mind that Unix manual pages (usually referred to as;man pages) are available for most commands from the shell. To read a page, use man: +In man, you can navigate with the arrow keys. Press / to search for text within the page, and q to quit. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +man apt-get +Updating the local package database and working with packages. + + + +man apt-cache +Querying the local package database. + + + +man dpkg +Working with individual package files and querying installed packages. + + +CentOS +man yum + + + +Fedora +man dnf + + + +FreeBSD Packages +man pkg +Working with pre-compiled binary packages. + + +FreeBSD Ports +man ports +Working with the Ports Collection. + + + +Conclusion and Further Reading +This guide provides an overview of basic operations that can be cross-referenced between systems, but only scratches the surface of a complex topic. For greater detail on a given system, you can consult the following resources: +This guide covers Ubuntu and Debian package management in detail. There's an official CentOS guide to managing software with~yum. There's a Fedora wiki page about~dnf, and an official manual for~dnf~itself. This guide covers FreeBSD package management using pkg. The FreeBSD Handbook;contains a;section on using the Ports Collection.
From 3222d42be2238b6ec366d4a7c59ccf8a12184fee Mon Sep 17 00:00:00 2001 From: tgeek77 Date: Sun, 17 Jan 2016 08:19:12 +0100 Subject: [PATCH 03/10] Adding templates and working documents. --- .../Jason-Evans/Github and TLDP-howto.lyx | 261 ++ .../Jason-Evans/Package Management Basics.lyx | 3210 +++++++++++++++++ .../Jason-Evans/Package Management Basics.xml | 532 +++ .../Jason-Evans/Templates/FAQ/README.faq | 6 + .../Jason-Evans/Templates/FAQ/ldp-faq.lyx | 137 + .../Jason-Evans/Templates/FAQ/ldp-faq.xml | 81 + .../Jason-Evans/Templates/FAQ/ldp-faq.xml.lyx | 137 + .../Jason-Evans/Templates/FAQ/ldp-faq.xml.tex | 15 + .../Jason-Evans/Templates/FAQ/ldp-faq.xml.txt | 79 + .../Jason-Evans/Templates/Guide/README.guide | 39 + .../Templates/Guide/ldp-appendix.xml | 33 + .../Templates/Guide/ldp-appendix.xml.lyx | 176 + .../Templates/Guide/ldp-appendix.xml.tex | 29 + .../Templates/Guide/ldp-appendix.xml.txt | 21 + .../Templates/Guide/ldp-bibliography.lyx | 216 ++ .../Templates/Guide/ldp-bibliography.xml | 68 + .../Templates/Guide/ldp-bibliography.xml.lyx~ | 224 ++ .../Templates/Guide/ldp-bibliography.xml.tex | 26 + .../Templates/Guide/ldp-bibliography.xml.txt | 49 + .../Templates/Guide/ldp-glossary.xml | 86 + .../Templates/Guide/ldp-glossary.xml.tex | 35 + .../Templates/Guide/ldp-glossary.xml.txt | 98 + .../Templates/Guide/ldp-guide-chap1.lyx | 248 ++ .../Templates/Guide/ldp-guide-chap1.xml | 53 + .../Templates/Guide/ldp-guide-chap1.xml.lyx | 255 ++ .../Templates/Guide/ldp-guide-chap1.xml.tex | 51 + .../Templates/Guide/ldp-guide-chap1.xml.txt | 48 + .../Templates/Guide/ldp-guide-chap2.lyx | 459 +++ .../Templates/Guide/ldp-guide-chap2.xml | 90 + .../Templates/Guide/ldp-guide-chap2.xml.lyx | 459 +++ .../Templates/Guide/ldp-guide-chap2.xml.lyx~ | 478 +++ .../Templates/Guide/ldp-guide-chap2.xml.tex | 92 + .../Templates/Guide/ldp-guide-chap2.xml.txt | 68 + .../Templates/Guide/ldp-guide-main.xml | 253 ++ .../Templates/Guide/ldp-guide-main.xml.lyx | 914 +++++ .../Templates/Guide/ldp-guide-main.xml.tex | 125 + .../Templates/Guide/ldp-guide-main.xml.txt | 124 + .../Templates/Howto/ldp-appendix.xml | 33 + .../Templates/Howto/ldp-appendix.xml.tex | 29 + .../Templates/Howto/ldp-appendix.xml.txt | 21 + .../Templates/Howto/ldp-bibliography.xml | 68 + .../Templates/Howto/ldp-bibliography.xml.tex | 26 + .../Templates/Howto/ldp-bibliography.xml.txt | 49 + .../Templates/Howto/ldp-glossary.lyx | 142 + .../Templates/Howto/ldp-glossary.xml | 86 + .../Templates/Howto/ldp-glossary.xml.lyx | 140 + .../Templates/Howto/ldp-glossary.xml.tex | 35 + .../Templates/Howto/ldp-glossary.xml.txt | 98 + .../Jason-Evans/Templates/Howto/ldp-howto.lyx | 1464 ++++++++ .../Templates/Howto/ldp-howto.lyx~ | 1472 ++++++++ .../Jason-Evans/Templates/Howto/ldp-howto.xml | 722 ++++ .../Templates/Howto/ldp-howto.xml.lyx | 1237 +++++++ .../Templates/Howto/ldp-howto.xml.tex | 473 +++ .../Templates/Howto/ldp-howto.xml.txt | 591 +++ 54 files changed, 15961 insertions(+) create mode 100644 LDP/users/Jason-Evans/Github and TLDP-howto.lyx create mode 100644 LDP/users/Jason-Evans/Package Management Basics.lyx create mode 100644 LDP/users/Jason-Evans/Package Management Basics.xml create mode 100644 LDP/users/Jason-Evans/Templates/FAQ/README.faq create mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx create mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml create mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.lyx create mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Guide/README.guide create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.lyx create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.tex create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.txt diff --git a/LDP/users/Jason-Evans/Github and TLDP-howto.lyx b/LDP/users/Jason-Evans/Github and TLDP-howto.lyx new file mode 100644 index 00000000..55f5031d --- /dev/null +++ b/LDP/users/Jason-Evans/Github and TLDP-howto.lyx @@ -0,0 +1,261 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass docbook +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +About this document +\end_layout + +\begin_layout Subsection +Copyright and License +\end_layout + +\begin_layout Standard +This work is licensed under the +\begin_inset CommandInset href +LatexCommand href +name "Creative Commons Attribution-ShareAlike 4.0 International License" +target "http://creativecommons.org/licenses/by-sa/4.0/" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Revision History +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +17.1.2016 +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +v1.0 First draft written +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Jason Evans +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Contributions +\end_layout + +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +name "Jason Evans" +target "http://wiki.tldp.org/Jason%20Evans" + +\end_inset + + (Original author and maintainer for TLDP) +\end_layout + +\begin_layout Subsection +Feedback +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "feedback" + +\end_inset + + +\end_layout + +\begin_layout Standard +Find something wrong with this document? (Or perhaps something right?) I + would love to hear from you. + Please email me at +\begin_inset CommandInset href +LatexCommand href +name "jsevans_at_youvegotthe.info" +target "jsevans_at_youvegotthe.info" +type "mailto:" + +\end_inset + +. +\end_layout + +\begin_layout Section +About My Topic +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "about" + +\end_inset + + +\end_layout + +\begin_layout Standard +In the past, The Linux Documentation Project used CVS as a version control + system, however a few years ago it was moved to GitHub but there was no + accompanying documentation for adding new material to TLDP +\end_layout + +\begin_layout Section +Installing Git +\end_layout + +\begin_layout Subsection +From Ubuntu or Debian +\end_layout + +\begin_layout Code + +$ sudo apt-get install git +\end_layout + +\begin_layout Subsection +From Fedora, CentOS, or RHEL +\end_layout + +\begin_layout Code + +$ sudo yum install git +\end_layout + +\begin_layout Subsection +From Fedora 23 or later +\end_layout + +\begin_layout Code + +$ sudo dnf install git +\end_layout + +\begin_layout Subsection +From OpenSuSE or SLES +\end_layout + +\begin_layout Code + +$ sudo zypper install git +\end_layout + +\begin_layout Section +Finding TLDP on GitHub +\end_layout + +\begin_layout Standard +TLDP's main GitHub url is +\begin_inset CommandInset href +LatexCommand href +target "https://github.com/tLDP/LDP" + +\end_inset + +. + Anyone can download the documents in TLDP anonymously, but an acount on + github.com is required to upload +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Package Management Basics.lyx b/LDP/users/Jason-Evans/Package Management Basics.lyx new file mode 100644 index 00000000..77761655 --- /dev/null +++ b/LDP/users/Jason-Evans/Package Management Basics.lyx @@ -0,0 +1,3210 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass docbook +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Title +Package Management Basics: apt, yum, dnf, pkg +\end_layout + +\begin_layout Section +Introduction +\end_layout + +\begin_layout Subsection +Why was this document written? +\end_layout + +\begin_layout Standard +Most modern Unix-like operating systems offer a centralized mechanism for + finding and installing software. + Software is usually distributed in the form of +\begin_inset space ~ +\end_inset + +packages, kept in +\begin_inset space ~ +\end_inset + +repositories. + Working with packages is known as +\begin_inset space ~ +\end_inset + +package management. + Packages provide the basic components of an operating system, along with + shared libraries, applications, services, and documentation. +\end_layout + +\begin_layout Standard +A package management system does much more than one-time installation of + software. + It also provides tools for upgrading already-installed packages. + Package repositories help to ensure that code has been vetted for use on + your system, and that the installed versions of software have been approved + by developers and package maintainers. +\end_layout + +\begin_layout Standard +When configuring servers or development environments, it's often necessary + look beyond official repositories. + Packages in the stable release of a distribution may be out of date, especially + where new or rapidly-changing software is concerned. + Nevertheless, package management is a vital skill for system administrators + and developers, and the wealth of packaged software for major distributions + is a tremendous resource. +\end_layout + +\begin_layout Standard +This guide is intended as a quick reference for the fundamentals of finding, + installing, and upgrading packages on a variety of distributions, and should + help you translate that knowledge between systems. +\end_layout + +\begin_layout Subsection +Audience +\end_layout + +\begin_layout Standard +For those new to Linux who need a basic understanding of package management. +\end_layout + +\begin_layout Subsection +Original version of this doc +\end_layout + +\begin_layout Standard +The original version of this guide can be found at +\begin_inset CommandInset href +LatexCommand href +name "Digital Ocean" +target "https://www.digitalocean.com/community/tutorials/package-management-basics-apt-yum-dnf-pkg" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Revision History +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +15.1.2016 +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +v1.0 converted and edited for TLDP +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Jason Evans +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Contributions +\end_layout + +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +name "Brennen Bearnes" +target "https://www.digitalocean.com/community/users/bpb" + +\end_inset + +(original author). +\end_layout + +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +name "Jason Evans" +target "http://wiki.tldp.org/Jason%20Evans" + +\end_inset + +(editor and maintainer for TLDP) +\end_layout + +\begin_layout Subsection +Feedback +\end_layout + +\begin_layout Standard +Missing information, missing links, missing characters? Mail it to the maintaine +r of this document: +\begin_inset CommandInset href +LatexCommand href +name "jsevans at youvegotthe.info" +target "jsevans at youvegotthe.info" +type "mailto:" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Copyright information +\end_layout + +\begin_layout Standard +This work is licensed under a +\begin_inset CommandInset href +LatexCommand href +name "Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License" +target "https://creativecommons.org/licenses/by-nc-sa/4.0/" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +What do you need? +\end_layout + +\begin_layout Standard +This guide covers Debian, Ubuntu, CentOS, Fedora, and FreeBSD and will require + one of those distributions to be installed +\end_layout + +\begin_layout Section +Package Management Systems: A Brief Overview +\end_layout + +\begin_layout Standard +Most package systems are built around collections of package files. + A package file is usually an archive which contains compiled binaries and + other resources making up the software, along with installation scripts. + Packages also contain valuable metadata, including their +\begin_inset space ~ +\end_inset + +dependencies, a list of other packages required to install and run them. +\end_layout + +\begin_layout Standard +While their functionality and benefits are broadly similar, packaging formats + and tools vary by platform: +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +Operating System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Format +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Tool(s) +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +.deb +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +apt, apt-cache, apt-get, dpkg +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +.deb +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +apt, apt-cache, apt-get, dpkg +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +.rpm +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +yum +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +.rpm +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +dnf +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Ports, +\begin_inset space ~ +\end_inset + +.txz +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +make, pkg +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Standard +In Debian and systems based on it, like Ubuntu, Linux Mint, and Raspbian, + the package format is the +\begin_inset space ~ +\end_inset + +.debfile. + APT, the Advanced Packaging Tool, provides commands used for most common + operations: Searching repositories, installing collections of packages + and their dependencies, and managing upgrades. + APT commands operate as a front-end to the lower-level +\begin_inset space ~ +\end_inset + +dpkg +\begin_inset space ~ +\end_inset + +utility, which handles the installation of individual +\begin_inset space ~ +\end_inset + +.deb +\begin_inset space ~ +\end_inset + +files on the local system, and is sometimes invoked directly. +\end_layout + +\begin_layout Standard +CentOS, Fedora, and other members of the Red Hat family use RPM files. + In CentOS, +\begin_inset space ~ +\end_inset + +yum +\begin_inset space ~ +\end_inset + +is used to interact with both individual package files and repositories. +\end_layout + +\begin_layout Standard +In recent versions of Fedora, +\begin_inset space ~ +\end_inset + +yum +\begin_inset space ~ +\end_inset + +has been supplanted by +\begin_inset space ~ +\end_inset + +dnf, a modernized fork which retains most ofyum's interface. +\end_layout + +\begin_layout Standard +FreeBSD's binary package system is administered with the +\begin_inset space ~ +\end_inset + +pkg +\begin_inset space ~ +\end_inset + +command. + FreeBSD also offers the Ports Collection, a local directory structure and + tools which allow the user to fetch, compile, and install packages directly + from source using Makefiles. + It's usually much more convenient to use +\begin_inset space ~ +\end_inset + +pkg, but occasionally a pre-compiled package is unavailable, or you may + need to change compile-time options. +\end_layout + +\begin_layout Subsection +Update Package Lists +\end_layout + +\begin_layout Standard +Most systems keep a local database of the packages available from remote + repositories. + It's best to update this database before installing or upgrading packages. + As a partial exception to this pattern, +\begin_inset space ~ +\end_inset + +yumand +\begin_inset space ~ +\end_inset + +dnf +\begin_inset space ~ +\end_inset + +will check for updates before performing some operations, but you can ask + them at any time whether updates are available. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get update +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +yum check-update +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +dnf check-update +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg update +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo portsnap fetch update +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Upgrade Installed Packages +\end_layout + +\begin_layout Standard +Making sure that all of the installed software on a machine stays up to + date would be an enormous undertaking without a package system. + You would have to track upstream changes and security alerts for hundreds + of different packages. + While a package manager doesn't solve every problem you'll encounter when + upgrading software, it does enable you to maintain most system components + with a few commands. +\end_layout + +\begin_layout Standard +On FreeBSD, upgrading installed ports can introduce breaking changes or + require manual configuration steps. + It's best to read +\begin_inset space ~ +\end_inset + +/usr/ports/UPDATING +\begin_inset space ~ +\end_inset + +before upgrading with +\begin_inset space ~ +\end_inset + +portmaster. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Notes +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get upgrade +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Only upgrades installed packages, where possible. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get dist-upgrade +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +May add or remove packages to satisfy new dependencies. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo yum update +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo dnf upgrade +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg upgrade +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +less /usr/ports/UPDATING +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Uses +\begin_inset space ~ +\end_inset + +less +\begin_inset space ~ +\end_inset + +to view update notes for ports (use arrow keys to scroll, pressq +\begin_inset space ~ +\end_inset + +to quit). +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +cd /usr/ports/ports-mgmt/portmaster && sudo make install && sudo portmaster + -a +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Installs +\begin_inset space ~ +\end_inset + +portmaster +\begin_inset space ~ +\end_inset + +and uses it to update installed ports. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Find a Package +\end_layout + +\begin_layout Standard +Most distributions offer a graphical or menu-driven front end to package + collections. + These can be a good way to browse by category and discover new software. + Often, however, the quickest and most effective way to locate a package + is to search with command-line tools. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Notes +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +apt-cache search +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +yum search +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +yum search all +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Searches all fields, including description. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +dnf search +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +dnf search all +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Searches all fields, including description. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +pkg search +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Searches by name. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +pkg search -f +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Searches by name, returning full descriptions. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +pkg search -D +\begin_inset space ~ +\end_inset + +search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Searches description. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +cd /usr/ports && make search name=package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Searches by name. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +cd /usr/ports && make search key=search_string +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Searches comments, descriptions, and dependencies. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +View Info About a Specific Package +\end_layout + +\begin_layout Standard +When deciding what to install, it's often helpful to read detailed descriptions + of packages. + Along with human-readable text, these often include metadata like version + numbers and a list of the package's dependencies. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Notes +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +apt-cache show +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Shows locally-cached info about a package. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +dpkg -s +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Shows the current installed status of a package. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +yum info +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +yum deplist +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Lists dependencies for a package. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +dnf info +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +dnf repoquery - +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + + +\backslash +/ +\end_layout + +\end_inset + +-requires +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Lists dependencies for a package. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +pkg info +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Shows info for an installed package. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +cd /usr/ports/category/port +\begin_inset space ~ +\end_inset + +&& cat pkg-descr +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Install a Package from Repositories +\end_layout + +\begin_layout Standard +Once you know the name of a package, you can usually install it and its + dependencies with a single command. + In general, you can supply multiple packages to install simply by listing + them all. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Notes +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get install +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get install +\begin_inset space ~ +\end_inset + +package1 package2 ... + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Installs all listed packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get install -y +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Assumes "yes" where +\begin_inset space ~ +\end_inset + +apt +\begin_inset space ~ +\end_inset + +would usually prompt to continue. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo yum install +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo yum install +\begin_inset space ~ +\end_inset + +package1 package2 ... + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Installs all listed packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo yum install -y +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Assumes "yes" where +\begin_inset space ~ +\end_inset + +yum +\begin_inset space ~ +\end_inset + +would usually prompt to continue. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo dnf install +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo dnf install +\begin_inset space ~ +\end_inset + +package1 package2 ... + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Installs all listed packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo dnf install -y +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Assumes "yes" where +\begin_inset space ~ +\end_inset + +dnf +\begin_inset space ~ +\end_inset + +would usually prompt to continue. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg install +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg install +\begin_inset space ~ +\end_inset + +package1 package2 ... + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Installs all listed packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +cd /usr/ports/category/port +\begin_inset space ~ +\end_inset + +&& sudo make install +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Builds and installs a port from source. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Install a Package from the Local Filesystem +\end_layout + +\begin_layout Standard +Sometimes, even though software isn't officially packaged for a given operating + system, a developer or vendor will offer package files for download. + You can usually retrieve these with your web browser, or viacurl +\begin_inset space ~ +\end_inset + +on the command line. + Once a package is on the target system, it can often be installed with + a single command. +\end_layout + +\begin_layout Standard +On Debian-derived systems, +\begin_inset space ~ +\end_inset + +dpkg +\begin_inset space ~ +\end_inset + +handles individual package files. + If a package has unmet dependencies, +\begin_inset space ~ +\end_inset + +gdebi +\begin_inset space ~ +\end_inset + +can often be used to retrieve them from official repositories. +\end_layout + +\begin_layout Standard +On CentOS and Fedora systems, +\begin_inset space ~ +\end_inset + +yum +\begin_inset space ~ +\end_inset + +and +\begin_inset space ~ +\end_inset + +dnf +\begin_inset space ~ +\end_inset + +are used to install individual files, and will also handle needed dependencies. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Notes +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo dpkg -i +\begin_inset space ~ +\end_inset + +package.deb +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get install -ygdebi && sudo gdebipackage.deb +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Installs and uses gdebi to install package.deb and retrieve any missing dependenc +ies. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo yum install +\begin_inset space ~ +\end_inset + +package.rpm +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo dnf install +\begin_inset space ~ +\end_inset + +package.rpm +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg add +\begin_inset space ~ +\end_inset + +package.txz +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg add -f +\begin_inset space ~ +\end_inset + +package.txz +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Installs package even if already installed. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Remove One or More Installed Packages +\end_layout + +\begin_layout Standard +Since a package manager knows what files are provided by a given package, + it can usually remove them cleanly from a system if the software is no + longer needed. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Notes +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get remove +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo apt-get autoremove +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Removes unneeded packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo yum remove +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo dnf erase +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg delete +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg autoremove +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Removes unneeded packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +sudo pkg delete +\begin_inset space ~ +\end_inset + +package +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +cd /usr/ports/path_to_port +\begin_inset space ~ +\end_inset + +&& make deinstall +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +De-installs an installed port. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Get Help +\end_layout + +\begin_layout Standard +In addition to web-based documentation, keep in mind that Unix manual pages + (usually referred to as +\begin_inset space ~ +\end_inset + +man pages) are available for most commands from the shell. + To read a page, use man: +\end_layout + +\begin_layout Code +$ man page +\end_layout + +\begin_layout Standard +In +\begin_inset space \space{} +\end_inset + +man, you can navigate with the arrow keys. + Press / to search for text within the page, and q to quit. +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +System +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Notes +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Debian / Ubuntu +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +man apt-get +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Updating the local package database and working with packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +man apt-cache +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Querying the local package database. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +man dpkg +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Working with individual package files and querying installed packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +CentOS +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +man yum +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Fedora +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +man dnf +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Packages +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +man pkg +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Working with pre-compiled binary packages. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +FreeBSD Ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +man ports +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Working with the Ports Collection. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Section +Conclusion and Further Reading +\end_layout + +\begin_layout Standard +This guide provides an overview of basic operations that can be cross-referenced + between systems, but only scratches the surface of a complex topic. + For greater detail on a given system, you can consult the following resources: +\end_layout + +\begin_layout Enumerate +\begin_inset CommandInset href +LatexCommand href +name "This guide" +target "https://www.digitalocean.com/community/tutorials/ubuntu-and-debian-package-management-essentials" + +\end_inset + + covers Ubuntu and Debian package management in detail. + +\end_layout + +\begin_layout Enumerate +There's an +\begin_inset CommandInset href +LatexCommand href +name "official CentOS guide to managing software with~" +target "https://www.centos.org/docs/5/html/yum/" + +\end_inset + + +\begin_inset CommandInset href +LatexCommand href +name "yum" +target "https://www.centos.org/docs/5/html/yum/" + +\end_inset + +. + +\end_layout + +\begin_layout Enumerate +There's a +\begin_inset CommandInset href +LatexCommand href +name "Fedora wiki page about~" +target "https://fedoraproject.org/wiki/Dnf" + +\end_inset + + +\begin_inset CommandInset href +LatexCommand href +name "dnf" +target "https://fedoraproject.org/wiki/Dnf" + +\end_inset + +, and an +\begin_inset CommandInset href +LatexCommand href +name "official manual for~" +target "https://dnf.readthedocs.org/en/latest/index.html" + +\end_inset + + +\begin_inset CommandInset href +LatexCommand href +name "dnf" +target "https://dnf.readthedocs.org/en/latest/index.html" + +\end_inset + + +\begin_inset CommandInset href +LatexCommand href +name "~itself" +target "https://dnf.readthedocs.org/en/latest/index.html" + +\end_inset + +. + +\end_layout + +\begin_layout Enumerate +\begin_inset CommandInset href +LatexCommand href +name "This guide" +target "https://www.digitalocean.com/community/tutorials/how-to-manage-packages-on-freebsd-10-1-with-pkg" + +\end_inset + + covers FreeBSD package management using pkg. + +\end_layout + +\begin_layout Enumerate +The +\begin_inset CommandInset href +LatexCommand href +name "FreeBSD Handbook" +target "https://www.freebsd.org/doc/handbook/" + +\end_inset + + +\begin_inset space ~ +\end_inset + +contains a +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset href +LatexCommand href +name "section on using the Ports Collection" +target "https://www.freebsd.org/doc/handbook/ports-using.html" + +\end_inset + +. + +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Package Management Basics.xml b/LDP/users/Jason-Evans/Package Management Basics.xml new file mode 100644 index 00000000..5a6bd455 --- /dev/null +++ b/LDP/users/Jason-Evans/Package Management Basics.xml @@ -0,0 +1,532 @@ + + + + +
+ +Package Management Basics: apt, yum, dnf, pkg + +Introduction + +Why was this document written? +Most modern Unix-like operating systems offer a centralized mechanism for finding and installing software. Software is usually distributed in the form of;packages, kept in;repositories. Working with packages is known as;package management. Packages provide the basic components of an operating system, along with shared libraries, applications, services, and documentation. +A package management system does much more than one-time installation of software. It also provides tools for upgrading already-installed packages. Package repositories help to ensure that code has been vetted for use on your system, and that the installed versions of software have been approved by developers and package maintainers. +When configuring servers or development environments, it's often necessary look beyond official repositories. Packages in the stable release of a distribution may be out of date, especially where new or rapidly-changing software is concerned. Nevertheless, package management is a vital skill for system administrators and developers, and the wealth of packaged software for major distributions is a tremendous resource. +This guide is intended as a quick reference for the fundamentals of finding, installing, and upgrading packages on a variety of distributions, and should help you translate that knowledge between systems. +Audience +For those new to Linux who need a basic understanding of package management. +Original version of this doc +The original version of this guide can be found at Digital Ocean. +Revision History + + + + + + +15.1.2016 +v1.0 converted and edited for TLDP +Jason Evans + + + +Contributions + +Brennen Bearnes (original author).Jason Evans (editor and maintainer for TLDP) +Feedback +Missing information, missing links, missing characters? Mail it to the maintainer of this document: jsevans at youvegotthe.info +Copyright information +This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. +What do you need? +This guide covers Debian, Ubuntu, CentOS, Fedora, and FreeBSD and will require one of those distributions to be installed +Package Management Systems: A Brief Overview +Most package systems are built around collections of package files. A package file is usually an archive which contains compiled binaries and other resources making up the software, along with installation scripts. Packages also contain valuable metadata, including their;dependencies, a list of other packages required to install and run them. +While their functionality and benefits are broadly similar, packaging formats and tools vary by platform: + + + + + + +Operating System +Format +Tool(s) + + + + +Debian +.deb +apt, apt-cache, apt-get, dpkg + + +Ubuntu +.deb +apt, apt-cache, apt-get, dpkg + + +CentOS +.rpm +yum + + +Fedora +.rpm +dnf + + +FreeBSD +Ports,;.txz +make, pkg + + + +In Debian and systems based on it, like Ubuntu, Linux Mint, and Raspbian, the package format is the;.debfile. APT, the Advanced Packaging Tool, provides commands used for most common operations: Searching repositories, installing collections of packages and their dependencies, and managing upgrades. APT commands operate as a front-end to the lower-level;dpkg;utility, which handles the installation of individual;.deb;files on the local system, and is sometimes invoked directly. +CentOS, Fedora, and other members of the Red Hat family use RPM files. In CentOS,;yum;is used to interact with both individual package files and repositories. +In recent versions of Fedora,;yum;has been supplanted by;dnf, a modernized fork which retains most ofyum's interface. +FreeBSD's binary package system is administered with the;pkg;command. FreeBSD also offers the Ports Collection, a local directory structure and tools which allow the user to fetch, compile, and install packages directly from source using Makefiles. It's usually much more convenient to use;pkg, but occasionally a pre-compiled package is unavailable, or you may need to change compile-time options. +Update Package Lists +Most systems keep a local database of the packages available from remote repositories. It's best to update this database before installing or upgrading packages. As a partial exception to this pattern,;yumand;dnf;will check for updates before performing some operations, but you can ask them at any time whether updates are available. + + + + + +System +Command + + + + +Debian / Ubuntu +sudo apt-get update + + +CentOS +yum check-update + + +Fedora +dnf check-update + + +FreeBSD Packages +sudo pkg update + + +FreeBSD Ports +sudo portsnap fetch update + + + +Upgrade Installed Packages +Making sure that all of the installed software on a machine stays up to date would be an enormous undertaking without a package system. You would have to track upstream changes and security alerts for hundreds of different packages. While a package manager doesn't solve every problem you'll encounter when upgrading software, it does enable you to maintain most system components with a few commands. +On FreeBSD, upgrading installed ports can introduce breaking changes or require manual configuration steps. It's best to read;/usr/ports/UPDATING;before upgrading with;portmaster. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo apt-get upgrade +Only upgrades installed packages, where possible. + + + +sudo apt-get dist-upgrade +May add or remove packages to satisfy new dependencies. + + +CentOS +sudo yum update + + + +Fedora +sudo dnf upgrade + + + +FreeBSD Packages +sudo pkg upgrade + + + +FreeBSD Ports +less /usr/ports/UPDATING +Uses;less;to view update notes for ports (use arrow keys to scroll, pressq;to quit). + + + +cd /usr/ports/ports-mgmt/portmaster && sudo make install && sudo portmaster -a +Installs;portmaster;and uses it to update installed ports. + + + +Find a Package +Most distributions offer a graphical or menu-driven front end to package collections. These can be a good way to browse by category and discover new software. Often, however, the quickest and most effective way to locate a package is to search with command-line tools. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +apt-cache search;search_string + + + +CentOS +yum search;search_string + + + + +yum search all;search_string +Searches all fields, including description. + + +Fedora +dnf search;search_string + + + + +dnf search all;search_string +Searches all fields, including description. + + +FreeBSD Packages +pkg search;search_string +Searches by name. + + + +pkg search -f;search_string +Searches by name, returning full descriptions. + + + +pkg search -D;search_string +Searches description. + + +FreeBSD Ports +cd /usr/ports && make search name=package +Searches by name. + + + +cd /usr/ports && make search key=search_string +Searches comments, descriptions, and dependencies. + + + +View Info About a Specific Package +When deciding what to install, it's often helpful to read detailed descriptions of packages. Along with human-readable text, these often include metadata like version numbers and a list of the package's dependencies. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +apt-cache show;package +Shows locally-cached info about a package. + + + +dpkg -s;package +Shows the current installed status of a package. + + +CentOS +yum info;package + + + + +yum deplist;package +Lists dependencies for a package. + + +Fedora +dnf info;package + + + + +dnf repoquery -\/-requires;package +Lists dependencies for a package. + + +FreeBSD Packages +pkg info;package +Shows info for an installed package. + + +FreeBSD Ports +cd /usr/ports/category/port;&& cat pkg-descr + + + + +Install a Package from Repositories +Once you know the name of a package, you can usually install it and its dependencies with a single command. In general, you can supply multiple packages to install simply by listing them all. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo apt-get install;package + + + + +sudo apt-get install;package1 package2 ... +Installs all listed packages. + + + +sudo apt-get install -y;package +Assumes "yes" where;apt;would usually prompt to continue. + + +CentOS +sudo yum install;package + + + + +sudo yum install;package1 package2 ... +Installs all listed packages. + + + +sudo yum install -y;package +Assumes "yes" where;yum;would usually prompt to continue. + + +Fedora +sudo dnf install;package + + + + +sudo dnf install;package1 package2 ... +Installs all listed packages. + + + +sudo dnf install -y;package +Assumes "yes" where;dnf;would usually prompt to continue. + + +FreeBSD Packages +sudo pkg install;package + + + + +sudo pkg install;package1 package2 ... +Installs all listed packages. + + +FreeBSD Ports +cd /usr/ports/category/port;&& sudo make install +Builds and installs a port from source. + + + +Install a Package from the Local Filesystem +Sometimes, even though software isn't officially packaged for a given operating system, a developer or vendor will offer package files for download. You can usually retrieve these with your web browser, or viacurl;on the command line. Once a package is on the target system, it can often be installed with a single command. +On Debian-derived systems,;dpkg;handles individual package files. If a package has unmet dependencies,;gdebi;can often be used to retrieve them from official repositories. +On CentOS and Fedora systems,;yum;and;dnf;are used to install individual files, and will also handle needed dependencies. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo dpkg -i;package.deb + + + + +sudo apt-get install -ygdebi && sudo gdebipackage.deb +Installs and uses gdebi to install package.deb and retrieve any missing dependencies. + + +CentOS +sudo yum install;package.rpm + + + +Fedora +sudo dnf install;package.rpm + + + +FreeBSD Packages +sudo pkg add;package.txz + + + + +sudo pkg add -f;package.txz +Installs package even if already installed. + + + +Remove One or More Installed Packages +Since a package manager knows what files are provided by a given package, it can usually remove them cleanly from a system if the software is no longer needed. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +sudo apt-get remove;package + + + + +sudo apt-get autoremove +Removes unneeded packages. + + +CentOS +sudo yum remove;package + + + +Fedora +sudo dnf erase;package + + + +FreeBSD Packages +sudo pkg delete;package + + + + +sudo pkg autoremove +Removes unneeded packages. + + +FreeBSD Ports +sudo pkg delete;package + + + + +cd /usr/ports/path_to_port;&& make deinstall +De-installs an installed port. + + + +Get Help +In addition to web-based documentation, keep in mind that Unix manual pages (usually referred to as;man pages) are available for most commands from the shell. To read a page, use man: +In man, you can navigate with the arrow keys. Press / to search for text within the page, and q to quit. + + + + + + +System +Command +Notes + + + + +Debian / Ubuntu +man apt-get +Updating the local package database and working with packages. + + + +man apt-cache +Querying the local package database. + + + +man dpkg +Working with individual package files and querying installed packages. + + +CentOS +man yum + + + +Fedora +man dnf + + + +FreeBSD Packages +man pkg +Working with pre-compiled binary packages. + + +FreeBSD Ports +man ports +Working with the Ports Collection. + + + +Conclusion and Further Reading +This guide provides an overview of basic operations that can be cross-referenced between systems, but only scratches the surface of a complex topic. For greater detail on a given system, you can consult the following resources: +This guide covers Ubuntu and Debian package management in detail. There's an official CentOS guide to managing software with~yum. There's a Fedora wiki page about~dnf, and an official manual for~dnf~itself. This guide covers FreeBSD package management using pkg. The FreeBSD Handbook;contains a;section on using the Ports Collection.
diff --git a/LDP/users/Jason-Evans/Templates/FAQ/README.faq b/LDP/users/Jason-Evans/Templates/FAQ/README.faq new file mode 100644 index 00000000..6cb2a3b8 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/FAQ/README.faq @@ -0,0 +1,6 @@ +The Linux Documentation Project :: FAQ DocBook Template +------------------------------------------------------- +The following document is provided as a template for your own FAQ. +We hope you found it useful. + +Please send suggestions to: feedback@tldp.org. diff --git a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx new file mode 100644 index 00000000..ddc71aa9 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx @@ -0,0 +1,137 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Standard + +\series bold +Q: +\series default + question 1 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 1 +\end_layout + +\begin_layout Standard + +\series bold +Q: +\series default + question 2 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 2 +\end_layout + +\begin_layout Standard + +\series bold +Q: +\series default + question 3 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 3 +\end_layout + +\begin_layout Standard + +\series bold +Q: +\series default + question 4 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 4 +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml new file mode 100644 index 00000000..64d56bd5 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml @@ -0,0 +1,81 @@ + + +
+ + XXX FAQ + + your first name + your last name + +
+you@your.domain +
+ + + date of first publication + + + number + date + initials + updates + + + + 1.0 + release date + your initials + First release for TLDP + + + + +
+ Copyright YYYY your full name. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at ). +
+ + + scope of the faq + + + + + + + + question 1 + + + answer 1 + + + + + + question 2 + + + answer 2 + + + + + + question 3 + + + answer 3 + + + + + + question 4 + + + answer 4 + + + + +
diff --git a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.lyx b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.lyx new file mode 100644 index 00000000..65aeec40 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.lyx @@ -0,0 +1,137 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Standard + +\series bold +Q: +\series default + question 1 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 1 +\end_layout + +\begin_layout Standard + +\series bold +Q: +\series default + question 2 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 2 +\end_layout + +\begin_layout Standard + +\series bold +Q: +\series default + question 3 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 3 +\end_layout + +\begin_layout Standard + +\series bold +Q: +\series default + question 4 +\end_layout + +\begin_layout Standard + +\series bold +A: +\series default + answer 4 +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.tex b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.tex new file mode 100644 index 00000000..3c0de9e6 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.tex @@ -0,0 +1,15 @@ +\textbf{Q:} question 1 + +\textbf{A:} answer 1 + +\textbf{Q:} question 2 + +\textbf{A:} answer 2 + +\textbf{Q:} question 3 + +\textbf{A:} answer 3 + +\textbf{Q:} question 4 + +\textbf{A:} answer 4 diff --git a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.txt b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.txt new file mode 100644 index 00000000..0059c4b3 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.txt @@ -0,0 +1,79 @@ +XXX FAQ + +\begin{verbatim} + + your first name + your last name + +
+\end{verbatim} + +you@your.domain + +\begin{verbatim} + + +date of first publication + + + number + date + initials + updates + + + + 1.0 + release date + your initials + First release for TLDP + + + + +
+ Copyright YYYY your full name. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at ). +
+ + + scope of the faq + +\end{verbatim} + +\begin{verbatim} + + + question 1 + + + answer 1 + + + + + + question 2 + + + answer 2 + + + + + + question 3 + + + answer 3 + + + + + + question 4 + + + answer 4 + + +\end{verbatim} diff --git a/LDP/users/Jason-Evans/Templates/Guide/README.guide b/LDP/users/Jason-Evans/Templates/Guide/README.guide new file mode 100644 index 00000000..7054b3b2 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/README.guide @@ -0,0 +1,39 @@ +The Linux Documentation Project :: Guide Template +------------------------------------------------- +The following documents are provided as templates for your own Guide +(book-length document). You are not required to use all of the templates +provided in this package for your document. They are only a suggestion of +what you might need based on the many documents we have reviewed and +accepted in our collection over the years. We hope you find them useful. + +These files are all in DocBook XML version 4.2. If you would prefer to use +LinuxDoc, please download the LinuxDoc templates. If you are writing your +document in a different format, please follow the instructions in the +Author Guide on how to transform your document into DocBook before +submitting it to the collection. +http://www.tldp.org/LDP/LDP-Author-Guide/html/x2docbook.html + +Please send suggestions to: feedback@tldp.org. + +ldp-appendix.xml + A sample appendix. Typically used for the full text of your document's + license and additional instructions that are not part of the "core" of + your document. + +ldp-bibliography.xml + A sample bibliography with sections. + +ldp-glossary.xml + A sample glossary. + +ldp-guide-chap1.xml and ldp-guide-chap2.xml + Two sample chapters with common DocBook markup. + +ldp-guide-main.xml + The main file that refers to each of the additional XML files. When the + file is transformed from XML to another format, this file is the master + outline that informs the processing tool where each of the components + are. + +If you are writing a shorter HOWTO, please use the ldp-howto.zip package +instead. diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml new file mode 100644 index 00000000..4e64c648 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml @@ -0,0 +1,33 @@ + + +Appendix one title + + +Says what this appendix is about, for instance further info on the web. + + + +further info + +about this subject + + +: about this and that. +: about other related stuff. +: more stuff. + + + + +about other subject + + +: about this and that. +: about other related stuff. +: more stuff. + + + + + + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.lyx new file mode 100644 index 00000000..78ad5f57 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.lyx @@ -0,0 +1,176 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Appendix one title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "app1" + +\end_inset + + +\end_layout + +\begin_layout Quote +Says what this appendix is about, for instance further info on the web. +\end_layout + +\begin_layout Section +further info +\end_layout + +\begin_layout Subsection +about this subject +\end_layout + +\begin_layout Itemize + +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://useful.org" + +\end_inset + +: about this and that. +\end_layout + +\begin_layout Itemize + +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://related.org" + +\end_inset + +: about other related stuff. +\end_layout + +\begin_layout Itemize + +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://other.org" + +\end_inset + +: more stuff. +\end_layout + +\begin_layout Subsection +about other subject +\end_layout + +\begin_layout Itemize + +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://useful2.org" + +\end_inset + +: about this and that. +\end_layout + +\begin_layout Itemize + +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://related2.org" + +\end_inset + +: about other related stuff. +\end_layout + +\begin_layout Itemize + +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://other2.org" + +\end_inset + +: more stuff. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.tex new file mode 100644 index 00000000..017d8d15 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.tex @@ -0,0 +1,29 @@ +\section{Appendix one title}\label{app1} + +\begin{quote} +Says what this appendix is about, for instance further info on the web. +\end{quote} + +\section{further info} + +\subsection{about this subject} + +\begin{itemize} +\item + \href{http://useful.org}{}: about this and that. +\item + \href{http://related.org}{}: about other related stuff. +\item + \href{http://other.org}{}: more stuff. +\end{itemize} + +\subsection{about other subject} + +\begin{itemize} +\item + \href{http://useful2.org}{}: about this and that. +\item + \href{http://related2.org}{}: about other related stuff. +\item + \href{http://other2.org}{}: more stuff. +\end{itemize} diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.txt b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.txt new file mode 100644 index 00000000..2457bf88 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.txt @@ -0,0 +1,21 @@ +Appendix one title + +Says what this appendix is about, for instance further info on the web. + +further info + +about this subject + +: about this and that. + +: about other related stuff. + +: more stuff. + +about other subject + +: about this and that. + +: about other related stuff. + +: more stuff. diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.lyx new file mode 100644 index 00000000..b0fa111c --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.lyx @@ -0,0 +1,216 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +References and Resources +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "bibliography" + +\end_inset + + +\end_layout + +\begin_layout Section +HOWTOs +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "ref-howto" + +\end_inset + + +\end_layout + +\begin_layout Standard +\begin_inset CommandInset href +LatexCommand href +target "URL" + +\end_inset + + +\end_layout + +\begin_layout Standard +\begin_inset CommandInset href +LatexCommand href +target "URL 2" + +\end_inset + + +\end_layout + +\begin_layout Section +Hardware-specific Install Reports and Info +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "ref-installreports" + +\end_inset + + +\end_layout + +\begin_layout Standard +\begin_inset CommandInset href +LatexCommand href +target "URL 3" + +\end_inset + + +\end_layout + +\begin_layout Standard +\begin_inset CommandInset href +LatexCommand href +target "URL 4" + +\end_inset + + +\end_layout + +\begin_layout Section +Mailing List Threads +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "ref-mailinglist" + +\end_inset + + +\end_layout + +\begin_layout Standard +\begin_inset CommandInset href +LatexCommand href +target "URL 5" + +\end_inset + + +\end_layout + +\begin_layout Section +Packages and related software +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "ref-software" + +\end_inset + + +\end_layout + +\begin_layout Standard +\begin_inset CommandInset href +LatexCommand href +target "http://www.kernel.org" + +\end_inset + + +\end_layout + +\begin_layout Quote +Remember to choose +\begin_inset Quotes eld +\end_inset + +F +\begin_inset Quotes erd +\end_inset + + for full when you download your kernel source. + +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml new file mode 100644 index 00000000..f46c042d --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml @@ -0,0 +1,68 @@ + + +References and Resources + + + + + + +HOWTOs + + + Document Title + + + + + Document Title 2 + + + + + + Hardware-specific Install Reports and Info + + + Installation Reports + + + + + Blacklist + + + + + +Mailing List Threads + + mailing_list_name thread: subject line + + + + +Packages and related software + + The Kernel + + Remember to choose "F" for full when you download your + kernel source. + + + + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ new file mode 100644 index 00000000..6a846ed6 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ @@ -0,0 +1,224 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +References and Resources +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "bibliography" + +\end_inset + + +\end_layout + +\begin_layout Section +HOWTOs +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "ref-howto" + +\end_inset + + +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "" +target "URL" + +\end_inset + + +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "" +target "URL 2" + +\end_inset + + +\end_layout + +\begin_layout Section +Hardware-specific Install Reports and Info +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "ref-installreports" + +\end_inset + + +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "" +target "URL 3" + +\end_inset + + +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "" +target "URL 4" + +\end_inset + + +\end_layout + +\begin_layout Section +Mailing List Threads +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "ref-mailinglist" + +\end_inset + + +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "" +target "URL 5" + +\end_inset + + +\end_layout + +\begin_layout Section +Packages and related software +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "ref-software" + +\end_inset + + +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://www.kernel.org" + +\end_inset + + +\end_layout + +\begin_layout Quote +Remember to choose "F" for full when you download your kernel source. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.tex new file mode 100644 index 00000000..f4c20ef7 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.tex @@ -0,0 +1,26 @@ +\section{References and Resources}\label{bibliography} + +\section{HOWTOs}\label{ref-howto} + +\href{URL}{} + +\href{URL 2}{} + +\section{Hardware-specific Install Reports and +Info}\label{ref-installreports} + +\href{URL 3}{} + +\href{URL 4}{} + +\section{Mailing List Threads}\label{ref-mailinglist} + +\href{URL 5}{} + +\section{Packages and related software}\label{ref-software} + +\href{http://www.kernel.org}{} + +\begin{quote} +Remember to choose "F" for full when you download your kernel source. +\end{quote} diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.txt b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.txt new file mode 100644 index 00000000..6d466f96 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.txt @@ -0,0 +1,49 @@ +References and Resources + +HOWTOs + +\begin{verbatim} + +Document Title + + + + +Document Title 2 + + +\end{verbatim} + +Hardware-specific Install Reports and Info + +\begin{verbatim} + +Installation Reports + + + + +Blacklist + + +\end{verbatim} + +Mailing List Threads + +\begin{verbatim} + +mailing_list_name thread: subject line + + +\end{verbatim} + +Packages and related software + +\begin{verbatim} + +The Kernel + +Remember to choose "F" for full when you download your +kernel source. + +\end{verbatim} diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml new file mode 100644 index 00000000..33715414 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml @@ -0,0 +1,86 @@ + + +Glossary + + +This is a glossary. + + +A + + + entryname + + definition + + + + + entryname + + definition + + + + + entryname + + definition + + + + + +B + + + entryname + + definition + + + + + entryname + + definition + + + + + entryname + + definition + + + + + +C + + + entryname + + definition + + + + + entryname + + definition + + + + + entryname + + definition + + + + + +And so on, for all the letters in the alphabet and all the items you want in the list. + + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.tex new file mode 100644 index 00000000..5698f7e7 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.tex @@ -0,0 +1,35 @@ +\section{Glossary}\label{glossary} + +\begin{quote} +This is a glossary. +\end{quote} + +\begin{description} +\item[entryname] +definition +\item[entryname] +definition +\item[entryname] +definition +\end{description} + +\begin{description} +\item[entryname] +definition +\item[entryname] +definition +\item[entryname] +definition +\end{description} + +\begin{description} +\item[entryname] +definition +\item[entryname] +definition +\item[entryname] +definition +\end{description} + +And so on, for all the letters in the alphabet and all the items you +want in the list. diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.txt b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.txt new file mode 100644 index 00000000..d9bce5b0 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.txt @@ -0,0 +1,98 @@ +Glossary + +This is a glossary. + +A + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + +B + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + +C + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + +And so on, for all the letters in the alphabet and all the items you +want in the list. diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.lyx new file mode 100644 index 00000000..9f23b929 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.lyx @@ -0,0 +1,248 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Title of first chapter +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "chapux5f01" + +\end_inset + + +\end_layout + +\begin_layout Quote +What we will do in this chapter: +\end_layout + +\begin_deeper +\begin_layout Itemize +stuff +\end_layout + +\begin_layout Itemize +more stuff +\end_layout + +\begin_layout Itemize +talk about other stuff +\end_layout + +\begin_layout Itemize +play with stuff +\end_layout + +\end_deeper +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Usually some introduction +\end_layout + +\begin_layout Standard +on all the aspects of stuff. +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +In-depth discussion +\end_layout + +\begin_layout Standard +Explain concepts. +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01ux5f03" + +\end_inset + + +\end_layout + +\begin_layout Standard +Maybe some examples +\end_layout + +\begin_layout Standard +And a hint to the next section of the chapter. +\end_layout + +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +More stuff +\end_layout + +\begin_layout Standard +More stuff +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is the second subsection of the second section of the first chapter. +\end_layout + +\begin_layout Standard +Add as many sections and subsections as you want. + +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml new file mode 100644 index 00000000..d268e6b5 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml @@ -0,0 +1,53 @@ + +Title of first chapter + + +What we will do in this chapter: + + +stuff +more stuff +talk about other stuff +play with stuff + + + + + +Section1 title + +Section2 title +Usually some introduction +on all the aspects of stuff. + + +Section2 title +In-depth discussion +Explain concepts. + + + +Section2 title +Maybe some examples +And a hint to the next section of the chapter. + + + + + +Section1 title + + +Section2 title +More stuff +More stuff + + + +Section2 title +This is the second subsection of the second section of the first chapter. +Add as many sections and subsections as you want. + + + + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.lyx new file mode 100644 index 00000000..22bd5671 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.lyx @@ -0,0 +1,255 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Title of first chapter +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "chapux5f01" + +\end_inset + + +\end_layout + +\begin_layout Quote +What we will do in this chapter: +\end_layout + +\begin_deeper +\begin_layout Itemize +stuff +\end_layout + +\begin_layout Itemize +more stuff +\end_layout + +\begin_layout Itemize +talk about other stuff +\end_layout + +\begin_layout Itemize +play with stuff +\end_layout + +\end_deeper +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Usually some introduction +\end_layout + +\begin_layout Standard +on all the aspects of stuff. +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +In-depth discussion +\end_layout + +\begin_layout Standard +Explain concepts. +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f01ux5f03" + +\end_inset + + +\end_layout + +\begin_layout Standard +Maybe some examples +\end_layout + +\begin_layout Standard +And a hint to the next section of the chapter. +\end_layout + +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +More stuff +\end_layout + +\begin_layout Standard +More stuff +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f01ux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is the second subsection of the second section of the first chapter. +\end_layout + +\begin_layout Standard +Add as many sections and subsections as you want. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.tex new file mode 100644 index 00000000..be7558ca --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.tex @@ -0,0 +1,51 @@ +\section{Title of first chapter}\label{chapux5f01} + +\begin{quote} +What we will do in this chapter: + +\begin{itemize} +\item + stuff +\item + more stuff +\item + talk about other stuff +\item + play with stuff +\end{itemize} +\end{quote} + +\section{Section1 title}\label{sectux5f01ux5f01} + +\subsection{Section2 title}\label{sectux5f01ux5f01ux5f01} + +Usually some introduction + +on all the aspects of stuff. + +\subsection{Section2 title}\label{sectux5f01ux5f01ux5f02} + +In-depth discussion + +Explain concepts. + +\subsection{Section2 title}\label{sectux5f01ux5f01ux5f03} + +Maybe some examples + +And a hint to the next section of the chapter. + +\section{Section1 title}\label{sectux5f01ux5f02} + +\subsection{Section2 title}\label{sectux5f01ux5f02ux5f01} + +More stuff + +More stuff + +\subsection{Section2 title}\label{sectux5f01ux5f02ux5f02} + +This is the second subsection of the second section of the first +chapter. + +Add as many sections and subsections as you want. diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.txt b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.txt new file mode 100644 index 00000000..df30207c --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.txt @@ -0,0 +1,48 @@ +Title of first chapter + +What we will do in this chapter: + +stuff + +more stuff + +talk about other stuff + +play with stuff + +Section1 title + +Section2 title + +Usually some introduction + +on all the aspects of stuff. + +Section2 title + +In-depth discussion + +Explain concepts. + +Section2 title + +Maybe some examples + +And a hint to the next section of the chapter. + +Section1 title + +Section2 title + +More stuff + +More stuff + +Section2 title + +This is the second subsection of the second section of the first +chapter. + +Add as many sections and subsections as you want. + + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.lyx new file mode 100644 index 00000000..e15ce572 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.lyx @@ -0,0 +1,459 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Title of second chapter +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "chapux5f02" + +\end_inset + + +\end_layout + +\begin_layout Quote +What we will do in this chapter: +\end_layout + +\begin_deeper +\begin_layout Itemize +stuff +\end_layout + +\begin_layout Itemize +more stuff +\end_layout + +\begin_layout Itemize +talk about other stuff +\end_layout + +\begin_layout Itemize +play with stuff +\end_layout + +\end_deeper +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsubsection +Section3 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Intro +\end_layout + +\begin_layout Standard +\begin_inset FormulaMacro +\newcommand{\labelenumi}{\arabic{enumi}.} +\end_inset + + +\end_layout + +\begin_layout Enumerate +Summing up a few things +\end_layout + +\begin_layout Enumerate +in a list +\end_layout + +\begin_layout Enumerate +where items are numbered +\end_layout + +\begin_layout Standard +Explanations +\end_layout + +\begin_layout Subsubsection +Section3 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Other explanation +\end_layout + +\begin_layout Itemize +Summing up a few things +\end_layout + +\begin_layout Itemize +in a list +\end_layout + +\begin_layout Itemize +where items are not numbered +\end_layout + +\begin_layout Standard +And discussion +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +Showing a picture in text: +\end_layout + +\begin_layout Standard +PNG is for on-line browsing, EPS for printing. + +\family typewriter +gimp +\family default + and/or +\family typewriter +convert +\family default + will do the trick, starting from about any source format. +\end_layout + +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is a table with two colums: +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset Caption Standard + +\begin_layout Plain Layout +Table title +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +first colum header +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +second colum header +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +first colum header +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +second colum header +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +meaning +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is a link to the first section of the first chapter: ?. +\end_layout + +\begin_layout Standard +This is an external link: +\begin_inset CommandInset href +LatexCommand href +target "http://www.somewhere.org" + +\end_inset + +. +\end_layout + +\begin_layout Standard +This is also +\begin_inset CommandInset href +LatexCommand href +name "an external link" +target "http://www.somewhere.org" + +\end_inset + +, only here you don't see the URL. + +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml new file mode 100644 index 00000000..eab864d1 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml @@ -0,0 +1,90 @@ + +Title of second chapter + + +What we will do in this chapter: + + +stuff +more stuff +talk about other stuff +play with stuff + + + + + +Section1 title + +Section2 title + +Section3 title +Intro + +Summing up a few things +in a list +where items are numbered + +Explanations + + +Section3 title +Other explanation + +Summing up a few things +in a list +where items are not numbered + +And discussion + + + + + +Section2 title +Showing a picture in text: + +
+ + + + + + +
+PNG is for on-line browsing, EPS for printing. gimp and/or convert will do the trick, starting from about any source format. + + + + + +Section1 title + + +Section2 title +This is a table with two colums: + +Table title + + +first colum headersecond colum header + + +itemmeaning +itemmeaning +itemmeaning + + +
+ + + + +Section2 title +This is a link to the first section of the first chapter: . +This is an external link: . +This is also an external link, only here you don't see the URL. + + + + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx new file mode 100644 index 00000000..e15ce572 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx @@ -0,0 +1,459 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Title of second chapter +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "chapux5f02" + +\end_inset + + +\end_layout + +\begin_layout Quote +What we will do in this chapter: +\end_layout + +\begin_deeper +\begin_layout Itemize +stuff +\end_layout + +\begin_layout Itemize +more stuff +\end_layout + +\begin_layout Itemize +talk about other stuff +\end_layout + +\begin_layout Itemize +play with stuff +\end_layout + +\end_deeper +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsubsection +Section3 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Intro +\end_layout + +\begin_layout Standard +\begin_inset FormulaMacro +\newcommand{\labelenumi}{\arabic{enumi}.} +\end_inset + + +\end_layout + +\begin_layout Enumerate +Summing up a few things +\end_layout + +\begin_layout Enumerate +in a list +\end_layout + +\begin_layout Enumerate +where items are numbered +\end_layout + +\begin_layout Standard +Explanations +\end_layout + +\begin_layout Subsubsection +Section3 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Other explanation +\end_layout + +\begin_layout Itemize +Summing up a few things +\end_layout + +\begin_layout Itemize +in a list +\end_layout + +\begin_layout Itemize +where items are not numbered +\end_layout + +\begin_layout Standard +And discussion +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +Showing a picture in text: +\end_layout + +\begin_layout Standard +PNG is for on-line browsing, EPS for printing. + +\family typewriter +gimp +\family default + and/or +\family typewriter +convert +\family default + will do the trick, starting from about any source format. +\end_layout + +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is a table with two colums: +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset Caption Standard + +\begin_layout Plain Layout +Table title +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +first colum header +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +second colum header +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +first colum header +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +second colum header +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +meaning +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is a link to the first section of the first chapter: ?. +\end_layout + +\begin_layout Standard +This is an external link: +\begin_inset CommandInset href +LatexCommand href +target "http://www.somewhere.org" + +\end_inset + +. +\end_layout + +\begin_layout Standard +This is also +\begin_inset CommandInset href +LatexCommand href +name "an external link" +target "http://www.somewhere.org" + +\end_inset + +, only here you don't see the URL. + +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ new file mode 100644 index 00000000..75444f98 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ @@ -0,0 +1,478 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Title of second chapter +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "chapux5f02" + +\end_inset + + +\end_layout + +\begin_layout Quote +What we will do in this chapter: +\end_layout + +\begin_deeper +\begin_layout Itemize +stuff +\end_layout + +\begin_layout Itemize +more stuff +\end_layout + +\begin_layout Itemize +talk about other stuff +\end_layout + +\begin_layout Itemize +play with stuff +\end_layout + +\end_deeper +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Subsubsection +Section3 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Intro +\end_layout + +\begin_deeper +\begin_layout Standard + +\begin_inset FormulaMacro +\def\labelenumi {\arabic{enumi}.} +\end_inset + + +\end_layout + +\end_deeper +\begin_layout Enumerate +Summing up a few things +\end_layout + +\begin_layout Enumerate +in a list +\end_layout + +\begin_layout Enumerate +where items are numbered +\end_layout + +\begin_layout Standard +Explanations +\end_layout + +\begin_layout Subsubsection +Section3 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f01ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Other explanation +\end_layout + +\begin_layout Itemize +Summing up a few things +\end_layout + +\begin_layout Itemize +in a list +\end_layout + +\begin_layout Itemize +where items are not numbered +\end_layout + +\begin_layout Standard +And discussion +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f01ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +Showing a picture in text: +\end_layout + +\begin_layout Standard + +\begin_inset Graphics + filename your_images_dir/image.eps + +\end_inset + + +\end_layout + +\begin_layout Standard +PNG is for on-line browsing, EPS for printing. +\family typewriter +gimp +\family default + and/or +\family typewriter +convert +\family default + will do the trick, starting from about any source format. +\end_layout + +\begin_layout Section +Section1 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02ux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is a table with two colums: +\end_layout + +\begin_layout Standard + +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset Caption Standard + +\begin_layout Plain Layout +Table title +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +first colum header +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +second colum header +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +first colum header +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +second colum header +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +item +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +meaning +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Section2 title +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "sectux5f02ux5f02ux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +This is a link to the first section of the first chapter: ?. +\end_layout + +\begin_layout Standard +This is an external link: +\begin_inset CommandInset href +LatexCommand href +name "" +target "http://www.somewhere.org" + +\end_inset + +. +\end_layout + +\begin_layout Standard +This is also +\begin_inset CommandInset href +LatexCommand href +name "an external link" +target "http://www.somewhere.org" + +\end_inset + +, only here you don't see the URL. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.tex new file mode 100644 index 00000000..8418561b --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.tex @@ -0,0 +1,92 @@ +\section{Title of second chapter}\label{chapux5f02} + +\begin{quote} +What we will do in this chapter: + +\begin{itemize} +\item + stuff +\item + more stuff +\item + talk about other stuff +\item + play with stuff +\end{itemize} +\end{quote} + +\section{Section1 title}\label{sectux5f02ux5f01} + +\subsection{Section2 title}\label{sectux5f02ux5f01ux5f01} + +\subsubsection{Section3 title}\label{sectux5f02ux5f01ux5f01ux5f01} + +Intro + +\begin{enumerate} +\def\labelenumi{\arabic{enumi}.} +\item + Summing up a few things +\item + in a list +\item + where items are numbered +\end{enumerate} + +Explanations + +\subsubsection{Section3 title}\label{sectux5f02ux5f01ux5f01ux5f01} + +Other explanation + +\begin{itemize} +\item + Summing up a few things +\item + in a list +\item + where items are not numbered +\end{itemize} + +And discussion + +\subsection{Section2 title}\label{sectux5f02ux5f01ux5f02} + +Showing a picture in text: + +\includegraphics{your_images_dir/image.eps} + +PNG is for on-line browsing, EPS for printing. \texttt{gimp} and/or +\texttt{convert} will do the trick, starting from about any source +format. + +\section{Section1 title}\label{sectux5f02ux5f02} + +\subsection{Section2 title}\label{sectux5f02ux5f02ux5f01} + +This is a table with two colums: + +\begin{longtable}[c]{@{}ll@{}} +\caption{Table title}\tabularnewline +\toprule +first colum header & second colum header\tabularnewline +\midrule +\endfirsthead +\toprule +first colum header & second colum header\tabularnewline +\midrule +\endhead +item & meaning\tabularnewline +item & meaning\tabularnewline +item & meaning\tabularnewline +\bottomrule +\end{longtable} + +\subsection{Section2 title}\label{sectux5f02ux5f02ux5f02} + +This is a link to the first section of the first chapter: ?. + +This is an external link: \href{http://www.somewhere.org}{}. + +This is also \href{http://www.somewhere.org}{an external link}, only +here you don't see the URL. diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.txt b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.txt new file mode 100644 index 00000000..d9918c9e --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.txt @@ -0,0 +1,68 @@ +Title of second chapter + +What we will do in this chapter: + +stuff + +more stuff + +talk about other stuff + +play with stuff + +Section1 title + +Section2 title + +Section3 title + +Intro + +Summing up a few things + +in a list + +where items are numbered + +Explanations + +Section3 title + +Other explanation + +Summing up a few things + +in a list + +where items are not numbered + +And discussion + +Section2 title + +Showing a picture in text: + +PNG is for on-line browsing, EPS for printing. gimp and/or convert will +do the trick, starting from about any source format. + +Section1 title + +Section2 title + +This is a table with two colums: + +Table title + +first colum headersecond colum header + +itemmeaning itemmeaning itemmeaning + +Section2 title + +This is a link to the first section of the first chapter: . + +This is an external link: . + +This is also an external link, only here you don't see the URL. + + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml new file mode 100644 index 00000000..9ddad775 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml @@ -0,0 +1,253 @@ + + + + + + +]> + + + + Your title + An optional subtitle + + + + Your given name + Your last name + + Your organization +
+ you@your.domain +
+ + + + +Optional version information + + + Add + as + many + keywords + as + you + want + . + + + + + + +Introduction + +
+Why was this document written? + +Some explanations. +
+ +
+Audience + +Explain for whom it has been written. +
+ +
+New versions of this doc + +Point to the latest version of this document. +
+ +
+Revision History + + + + 1.2 + 2003-02-28 + MG + More stuff you changed. + + + 1.1 + 2003-01-22 + MG + Stuff you changed. + + + 1.0 + 2002-12-29 + MG + Initial release for TLDP + + + +
+ +
+Contributions + +Thank people who helped realizing this doc. +
+ +
+Feedback + + +Missing information, missing links, missing characters? Mail it to the +maintainer of this document:
you@your.domain
+ +
+ +
+Copyright information + +Copyright 2002 Your_first_name Your_last_name. + + Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or any later +version published by the Free Software Foundation; with no Invariant +Sections, with no Front-Cover Texts and no Back-Cover Texts. A copy of the +license is included in entitled GNU Free +Documentation License. + +Read The GNU Manifesto + if you want to know why this license was chosen for this book. + + +The author and publisher have made every effort in the preparation of this +book to ensure the accuracy of the information. However, the information +contained in this book is offered without warranty, either express or implied. +Neither the author nor the publisher nor any dealer or distributor will be held +liable for any damages caused or alleged to be caused either directly or +indirectly by this book. + + +The logos, trademarks and symbols used in this book are the properties of +their respective owners. + +
+ +
+What do you need? + +List requirements: materials, knowledge. +
+ +
+Conventions used in this document +The following typographic and usage conventions occur in this text: + + +Typographic and usage conventions + + + +Text typeMeaning + + + + +Quoted text +Quotes from people, quoted computer output. + + +terminal view +Literal computer input and output captured from the terminal, +usually rendered with a light grey background. + + +command +Name of a command that can be entered on the command line. + + +VARIABLE +Name of a variable or pointer to content of a variable, as in +$VARNAME. + + + +Option to a command, as in the option to the +ls command. + + +argument +Argument to a command, as in read +man ls. + + +command +arguments +Command synopsis or general usage, on a separated line. + + +filename +Name of a file or directory, for example Change to the +/usr/bin directory. + + +Key +Keys to hit on the keyboard, such as type Q +to quit. + + +Button +Graphical button to click, like the OK +button. + + +MenuChoice + +Choice to select from a graphical menu, for instance: Select +HelpAbout Mozilla + in your browser. + + +Terminology +Important term or concept: The Linux kernel +is the heart of the system. + + +See link to related subject +within this guide. + + +The author +Clickable link to an external web resource. + + + + +
+ +
+ +
+Organization of this document + +List chapters (and optionally, appendices) with a short content for each (only for longer docs). + +: short description. +: short description. +: short description. +: short description. +: short description. + + +
+ + + + + +&chap1; +&chap2; +&app1; +&gloss; + diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.lyx new file mode 100644 index 00000000..5649bb7e --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.lyx @@ -0,0 +1,914 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Introduction +\end_layout + +\begin_layout Subsection +Why was this document written? +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f01" + +\end_inset + + +\end_layout + +\begin_layout Standard +Some explanations. +\end_layout + +\begin_layout Subsection +Audience +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f02" + +\end_inset + + +\end_layout + +\begin_layout Standard +Explain for whom it has been written. +\end_layout + +\begin_layout Subsection +New versions of this doc +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f03" + +\end_inset + + +\end_layout + +\begin_layout Standard +Point to +\begin_inset CommandInset href +LatexCommand href +name "the latest version" +target "http://somewhere.org" + +\end_inset + +of this document. +\end_layout + +\begin_layout Subsection +Revision History +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f04" + +\end_inset + + +\end_layout + +\begin_layout Standard +1.2 2003-02-28 MG More stuff you changed. 1.1 2003-01-22 MG Stuff you changed. 1.0 2002-12-29 MG Initial release for TLDP +\end_layout + +\begin_layout Subsection +Contributions +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f05" + +\end_inset + + +\end_layout + +\begin_layout Standard +Thank people who helped realizing this doc. +\end_layout + +\begin_layout Subsection +Feedback +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f06" + +\end_inset + + +\end_layout + +\begin_layout Standard +Missing information, missing links, missing characters? Mail it to the maintainer of this document: +\begin_inset CommandInset href +LatexCommand href +name "nolinkurl{you@your.domain}" +target "you@your.domain" +type "mailto:" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Copyright information +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f07" + +\end_inset + + +\end_layout + +\begin_layout Standard +Copyright 2002 Your_first_name Your_last_name. +\end_layout + +\begin_layout Standard +Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. A copy of the license is included in ? entitled +\begin_inset Quotes eld +\end_inset + +GNU Free Documentation License +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\begin_layout Standard +Read +\begin_inset CommandInset href +LatexCommand href +name "The GNU Manifesto" +target "http://www.fsf.org/gnu/manifesto.html" + +\end_inset + +if you want to know why this license was chosen for this book. +\end_layout + +\begin_layout Standard +The author and publisher have made every effort in the preparation of this book to ensure the accuracy of the information. However, the information contained in this book is offered without warranty, either express or implied. Neither the author nor the publisher nor any dealer or distributor will be held liable for any damages caused or alleged to be caused either directly or indirectly by this book. +\end_layout + +\begin_layout Standard +The logos, trademarks and symbols used in this book are the properties of their respective owners. +\end_layout + +\begin_layout Subsection +What do you need? +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f08" + +\end_inset + + +\end_layout + +\begin_layout Standard +List requirements: materials, knowledge. +\end_layout + +\begin_layout Subsection +Conventions used in this document +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f09" + +\end_inset + + +\end_layout + +\begin_layout Standard +The following typographic and usage conventions occur in this text: +\end_layout + +\begin_layout Standard + +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset Caption Standard + +\begin_layout Plain Layout +Typographic and usage conventions +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset Quotes eld +\end_inset + +Quoted text +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Quotes from people, quoted computer output. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Verbatim +terminal view +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Literal computer input and output captured from the terminal, usually rendered with a light grey background. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +command +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Name of a command that can be entered on the command line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +VARIABLE +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Name of a variable or pointer to content of a variable, as in +\family typewriter +$VARNAME +\family default +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +option +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Option to a command, as in +\begin_inset Quotes eld +\end_inset + +the +\family typewriter +-a +\family default + option to the +\family typewriter +ls +\family default + command +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +argument +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Argument to a command, as in +\begin_inset Quotes eld +\end_inset + +read +\family typewriter +man +\begin_inset space \space{} + +\end_inset + +ls +\family default + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +command +\begin_inset space \space{} + +\end_inset + +options +\begin_inset space \space{} + +\end_inset + +arguments +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Command synopsis or general usage, on a separated line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +filename +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Name of a file or directory, for example +\begin_inset Quotes eld +\end_inset + +Change to the +\family typewriter +/usr/bin +\family default + directory. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +Key +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Keys to hit on the keyboard, such as +\begin_inset Quotes eld +\end_inset + +type Q to quit +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +Button +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Graphical button to click, like the OK button. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{ +\end_layout + +\end_inset + +Menu +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{} +\end_layout + +\end_inset + + Choice +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +} +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Choice to select from a graphical menu, for instance: +\begin_inset Quotes eld +\end_inset + +Select +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{ +\end_layout + +\end_inset + +Help +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{} +\end_layout + +\end_inset + + About Mozilla +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +} +\end_layout + +\end_inset + + in your browser. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\emph on +Terminology +\emph default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Important term or concept: +\begin_inset Quotes eld +\end_inset + +The Linux +\emph on +kernel +\emph default + is the heart of the system. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +See ? +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +link to related subject within this guide. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "The author" +target "http://tille.soti.org" + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Clickable link to an external web resource. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Subsection +Organization of this document +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "introux5f10" + +\end_inset + + +\end_layout + +\begin_layout Standard +List chapters (and optionally, appendices) with a short content for each (only for longer docs). +\end_layout + +\begin_layout Itemize +?: short description. +\end_layout + +\begin_layout Itemize +?: short description. +\end_layout + +\begin_layout Itemize +?: short description. +\end_layout + +\begin_layout Itemize +?: short description. +\end_layout + +\begin_layout Itemize +?: short description. +\end_layout + +\begin_layout Standard +CHAP1 CHAP2 APP1 GLOSS +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.tex new file mode 100644 index 00000000..c77e09d2 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.tex @@ -0,0 +1,125 @@ +\section{Introduction} + +\subsection{Why was this document written?}\label{introux5f01} + +Some explanations. + +\subsection{Audience}\label{introux5f02} + +Explain for whom it has been written. + +\subsection{New versions of this doc}\label{introux5f03} + +Point to \href{http://somewhere.org}{the latest version} of this +document. + +\subsection{Revision History}\label{introux5f04} + +1.2 2003-02-28 MG More stuff you changed. 1.1 2003-01-22 MG Stuff you +changed. 1.0 2002-12-29 MG Initial release for TLDP + +\subsection{Contributions}\label{introux5f05} + +Thank people who helped realizing this doc. + +\subsection{Feedback}\label{introux5f06} + +Missing information, missing links, missing characters? Mail it to the +maintainer of this document: +\href{mailto:you@your.domain}{\nolinkurl{you@your.domain}} + +\subsection{Copyright information}\label{introux5f07} + +Copyright 2002 Your\_first\_name Your\_last\_name. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. A +copy of the license is included in ? entitled ``GNU Free Documentation +License''. + +Read \href{http://www.fsf.org/gnu/manifesto.html}{The GNU Manifesto} if +you want to know why this license was chosen for this book. + +The author and publisher have made every effort in the preparation of +this book to ensure the accuracy of the information. However, the +information contained in this book is offered without warranty, either +express or implied. Neither the author nor the publisher nor any dealer +or distributor will be held liable for any damages caused or alleged to +be caused either directly or indirectly by this book. + +The logos, trademarks and symbols used in this book are the properties +of their respective owners. + +\subsection{What do you need?}\label{introux5f08} + +List requirements: materials, knowledge. + +\subsection{Conventions used in this document}\label{introux5f09} + +The following typographic and usage conventions occur in this text: + +\begin{longtable}[c]{@{}ll@{}} +\caption{Typographic and usage conventions}\tabularnewline +\toprule +Text type & Meaning\tabularnewline +\midrule +\endfirsthead +\toprule +Text type & Meaning\tabularnewline +\midrule +\endhead +``Quoted text'' & Quotes from people, quoted computer +output.\tabularnewline +\begin{verbatim} +terminal view +\end{verbatim} + & Literal computer input and output captured from the terminal, usually +rendered with a light grey background.\tabularnewline +\texttt{command} & Name of a command that can be entered on the command +line.\tabularnewline +\texttt{VARIABLE} & Name of a variable or pointer to content of a +variable, as in \texttt{\$VARNAME}.\tabularnewline +\texttt{option} & Option to a command, as in ``the \texttt{-a} option to +the \texttt{ls} command''.\tabularnewline +\texttt{argument} & Argument to a command, as in ``read +\texttt{man\ ls}''.\tabularnewline +\texttt{command\ options\ +arguments} & Command synopsis or general usage, on a separated +line.\tabularnewline +\texttt{filename} & Name of a file or directory, for example ``Change to +the \texttt{/usr/bin} directory.''\tabularnewline +Key & Keys to hit on the keyboard, such as ``type Q to +quit''.\tabularnewline +Button & Graphical button to click, like the OK button.\tabularnewline +{Menu \textgreater{} Choice} & Choice to select from a graphical menu, +for instance: ``Select {Help \textgreater{} About Mozilla} in your +browser.''\tabularnewline +\emph{Terminology} & Important term or concept: ``The Linux +\emph{kernel} is the heart of the system.''\tabularnewline +See ? & link to related subject within this guide.\tabularnewline +\href{http://tille.soti.org}{The author} & Clickable link to an external +web resource.\tabularnewline +\bottomrule +\end{longtable} + +\subsection{Organization of this document}\label{introux5f10} + +List chapters (and optionally, appendices) with a short content for each +(only for longer docs). + +\begin{itemize} +\item + ?: short description. +\item + ?: short description. +\item + ?: short description. +\item + ?: short description. +\item + ?: short description. +\end{itemize} + +CHAP1 CHAP2 APP1 GLOSS diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.txt b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.txt new file mode 100644 index 00000000..a791d590 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.txt @@ -0,0 +1,124 @@ +{]}\textgreater{} + +Your title + +\begin{verbatim} +An optional subtitle +\end{verbatim} + + Your given name Your last name Your organization + +\begin{verbatim} + you@your.domain +
+ +\end{verbatim} + +Optional version information + + Add as many keywords as you want . + +Introduction + +Why was this document written? + +Some explanations. + +Audience + +Explain for whom it has been written. + +New versions of this doc + +Point to the latest version of this document. + +Revision History + + 1.2 2003-02-28 MG More stuff you changed. 1.1 2003-01-22 MG Stuff you +changed. 1.0 2002-12-29 MG Initial release for TLDP + +Contributions + +Thank people who helped realizing this doc. + +Feedback + +Missing information, missing links, missing characters? Mail it to the +maintainer of this document: + +you@your.domain + +Copyright information + +Copyright 2002 Your\_first\_name Your\_last\_name. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with no +Invariant Sections, with no Front-Cover Texts and no Back-Cover Texts. A +copy of the license is included in entitled GNU Free Documentation +License. + +Read The GNU Manifesto if you want to know why this license was chosen +for this book. + +The author and publisher have made every effort in the preparation of +this book to ensure the accuracy of the information. However, the +information contained in this book is offered without warranty, either +express or implied. Neither the author nor the publisher nor any dealer +or distributor will be held liable for any damages caused or alleged to +be caused either directly or indirectly by this book. + +The logos, trademarks and symbols used in this book are the properties +of their respective owners. + +What do you need? + +List requirements: materials, knowledge. + +Conventions used in this document + +The following typographic and usage conventions occur in this text: + +Typographic and usage conventions + +Text typeMeaning + + Quoted text Quotes from people, quoted computer output. + +terminal view + + Literal computer input and output captured from the terminal, usually +rendered with a light grey background. command Name of a command that +can be entered on the command line. VARIABLE Name of a variable or +pointer to content of a variable, as in \$VARNAME. option Option to a +command, as in the -a option to the ls command. argument Argument to a +command, as in read man ls. + +command options arguments + + Command synopsis or general usage, on a separated line. filename Name +of a file or directory, for example Change to the /usr/bin directory. +Key Keys to hit on the keyboard, such as type Q to quit. Button +Graphical button to click, like the OK button. MenuChoice Choice to +select from a graphical menu, for instance: Select HelpAbout Mozilla in +your browser. Terminology Important term or concept: The Linux kernel is +the heart of the system. See link to related subject within this guide. +The author Clickable link to an external web resource. + +Organization of this document + +List chapters (and optionally, appendices) with a short content for each +(only for longer docs). + +: short description. + +: short description. + +: short description. + +: short description. + +: short description. + +\&chap1; \&chap2; \&app1; \&gloss; diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml new file mode 100644 index 00000000..4e64c648 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml @@ -0,0 +1,33 @@ + + +Appendix one title + + +Says what this appendix is about, for instance further info on the web. + + + +further info + +about this subject + + +: about this and that. +: about other related stuff. +: more stuff. + + + + +about other subject + + +: about this and that. +: about other related stuff. +: more stuff. + + + + + + diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.tex b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.tex new file mode 100644 index 00000000..017d8d15 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.tex @@ -0,0 +1,29 @@ +\section{Appendix one title}\label{app1} + +\begin{quote} +Says what this appendix is about, for instance further info on the web. +\end{quote} + +\section{further info} + +\subsection{about this subject} + +\begin{itemize} +\item + \href{http://useful.org}{}: about this and that. +\item + \href{http://related.org}{}: about other related stuff. +\item + \href{http://other.org}{}: more stuff. +\end{itemize} + +\subsection{about other subject} + +\begin{itemize} +\item + \href{http://useful2.org}{}: about this and that. +\item + \href{http://related2.org}{}: about other related stuff. +\item + \href{http://other2.org}{}: more stuff. +\end{itemize} diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.txt b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.txt new file mode 100644 index 00000000..2457bf88 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.txt @@ -0,0 +1,21 @@ +Appendix one title + +Says what this appendix is about, for instance further info on the web. + +further info + +about this subject + +: about this and that. + +: about other related stuff. + +: more stuff. + +about other subject + +: about this and that. + +: about other related stuff. + +: more stuff. diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml new file mode 100644 index 00000000..f46c042d --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml @@ -0,0 +1,68 @@ + + +References and Resources + + + + + + +HOWTOs + + + Document Title + + + + + Document Title 2 + + + + + + Hardware-specific Install Reports and Info + + + Installation Reports + + + + + Blacklist + + + + + +Mailing List Threads + + mailing_list_name thread: subject line + + + + +Packages and related software + + The Kernel + + Remember to choose "F" for full when you download your + kernel source. + + + + diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.tex b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.tex new file mode 100644 index 00000000..f4c20ef7 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.tex @@ -0,0 +1,26 @@ +\section{References and Resources}\label{bibliography} + +\section{HOWTOs}\label{ref-howto} + +\href{URL}{} + +\href{URL 2}{} + +\section{Hardware-specific Install Reports and +Info}\label{ref-installreports} + +\href{URL 3}{} + +\href{URL 4}{} + +\section{Mailing List Threads}\label{ref-mailinglist} + +\href{URL 5}{} + +\section{Packages and related software}\label{ref-software} + +\href{http://www.kernel.org}{} + +\begin{quote} +Remember to choose "F" for full when you download your kernel source. +\end{quote} diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.txt b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.txt new file mode 100644 index 00000000..6d466f96 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.txt @@ -0,0 +1,49 @@ +References and Resources + +HOWTOs + +\begin{verbatim} + +Document Title + + + + +Document Title 2 + + +\end{verbatim} + +Hardware-specific Install Reports and Info + +\begin{verbatim} + +Installation Reports + + + + +Blacklist + + +\end{verbatim} + +Mailing List Threads + +\begin{verbatim} + +mailing_list_name thread: subject line + + +\end{verbatim} + +Packages and related software + +\begin{verbatim} + +The Kernel + +Remember to choose "F" for full when you download your +kernel source. + +\end{verbatim} diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.lyx b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.lyx new file mode 100644 index 00000000..7a9aa7fb --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.lyx @@ -0,0 +1,142 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Glossary +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "glossary" + +\end_inset + + +\end_layout + +\begin_layout Quote +This is a glossary. + +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout --Separator-- + +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout --Separator-- + +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Standard +And so on, for all the letters in the alphabet and all the items you want + in the list. + +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml new file mode 100644 index 00000000..33715414 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml @@ -0,0 +1,86 @@ + + +Glossary + + +This is a glossary. + + +A + + + entryname + + definition + + + + + entryname + + definition + + + + + entryname + + definition + + + + + +B + + + entryname + + definition + + + + + entryname + + definition + + + + + entryname + + definition + + + + + +C + + + entryname + + definition + + + + + entryname + + definition + + + + + entryname + + definition + + + + + +And so on, for all the letters in the alphabet and all the items you want in the list. + + diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.lyx b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.lyx new file mode 100644 index 00000000..19d50c14 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.lyx @@ -0,0 +1,140 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +Glossary +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "glossary" + +\end_inset + + +\end_layout + +\begin_layout Quote +This is a glossary. +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout --Separator-- + +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout --Separator-- + +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Description +entryname definition +\end_layout + +\begin_layout Standard +And so on, for all the letters in the alphabet and all the items you want in the list. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.tex b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.tex new file mode 100644 index 00000000..5698f7e7 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.tex @@ -0,0 +1,35 @@ +\section{Glossary}\label{glossary} + +\begin{quote} +This is a glossary. +\end{quote} + +\begin{description} +\item[entryname] +definition +\item[entryname] +definition +\item[entryname] +definition +\end{description} + +\begin{description} +\item[entryname] +definition +\item[entryname] +definition +\item[entryname] +definition +\end{description} + +\begin{description} +\item[entryname] +definition +\item[entryname] +definition +\item[entryname] +definition +\end{description} + +And so on, for all the letters in the alphabet and all the items you +want in the list. diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.txt b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.txt new file mode 100644 index 00000000..d9bce5b0 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.txt @@ -0,0 +1,98 @@ +Glossary + +This is a glossary. + +A + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + +B + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + +\end{verbatim} + +C + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + + entryname + +definition + +\begin{verbatim} + + + +\end{verbatim} + +And so on, for all the letters in the alphabet and all the items you +want in the list. diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx new file mode 100644 index 00000000..0639364a --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx @@ -0,0 +1,1464 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +About this document +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "about" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Copyright and License +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "copyright" + +\end_inset + + +\end_layout + +\begin_layout Standard +Copyright (c) YEAR by YOUR NAME. +\end_layout + +\begin_layout Standard +Permission is granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation License, Version 1.1 or any later + version published by the Free Software Foundation; with no Invariant Sections, + no Front-Cover Texts, and with no Back-Cover Texts. + A copy of the license is included in ?. +\end_layout + +\begin_layout Subsection +Translations +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "translations" + +\end_inset + + +\end_layout + +\begin_layout Standard +If you know of any translations for this document, or you are interested + in translating it, please email me +\begin_inset CommandInset href +LatexCommand href +target "YOUR EMAIL" +type "mailto:" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Preface +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "preface" + +\end_inset + + +\end_layout + +\begin_layout Standard +Tell us why you decided to write this document. +\end_layout + +\begin_layout Subsection +Acknowledgments +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "thanks" + +\end_inset + + +\end_layout + +\begin_layout Standard +No one ever writes documentation by themselves. + Please take the time to thank the people who have helped you. +\end_layout + +\begin_layout Subsection +Feedback +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "feedback" + +\end_inset + + +\end_layout + +\begin_layout Standard +Find something wrong with this document? (Or perhaps something right?) I + would love to hear from you. + Please email me at +\begin_inset CommandInset href +LatexCommand href +target "YOUR EMAIL" +type "mailto:" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Conventions used in this document +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "conventions" + +\end_inset + + +\end_layout + +\begin_layout Standard +The following typographic and usage conventions occur in this text: +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset Caption Standard + +\begin_layout Plain Layout +Typographic and usage conventions +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset Quotes eld +\end_inset + +Quoted text +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Quotes from people, quoted computer output. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +terminal view +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Literal computer input and output captured from the terminal. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +command +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Name of a command that can be entered on the command line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +option +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Option to a command, as in +\begin_inset Quotes eld +\end_inset + +the +\family typewriter +-a +\family default + option to the +\family typewriter +ls +\family default + command +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +parameter +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Parameter to a command, as in +\begin_inset Quotes eld +\end_inset + +read +\family typewriter +man +\begin_inset space \space{} +\end_inset + +ls +\family default + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +command +\begin_inset space \space{} +\end_inset + +options +\begin_inset space \space{} +\end_inset + +arguments +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command synopsis or general usage, on a separated line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +filename +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Name of a file or directory, for example +\begin_inset Quotes eld +\end_inset + +Change to the +\family typewriter +/usr/bin +\family default + directory. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{ +\end_layout + +\end_inset + +Menu +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{} +\end_layout + +\end_inset + + Choice +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +} +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Choice to select from a graphical menu, for instance: +\begin_inset Quotes eld +\end_inset + +Select +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{ +\end_layout + +\end_inset + +Help +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{} +\end_layout + +\end_inset + + About Mozilla +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +} +\end_layout + +\end_inset + + in your browser. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset CommandInset href +LatexCommand href +name "The author" +target "http://www.xtrinsic.com" + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Click-able link to an external web resource. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Standard +Thanks to Machtelt +\begin_inset Quotes eld +\end_inset + +Tille +\begin_inset Quotes erd +\end_inset + + Garrels for this list of conventions. +\end_layout + +\begin_layout Section +About My Topic +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "about" + +\end_inset + + +\end_layout + +\begin_layout Standard +Start by explaining the basics of your topic. + Is a brief history lesson in order? +\end_layout + +\begin_layout Subsection +Distribution News +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "distro-news" + +\end_inset + + +\end_layout + +\begin_layout Standard +If there is any news specific to each of the distrobutions of Linux, you + can include it here. +\end_layout + +\begin_layout Section +Installing from scratch +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "install" + +\end_inset + + +\end_layout + +\begin_layout Standard +Write down each of the steps on how to install any necessary packages/software/e +tc. + Do you need to recompile the kernel to activate new options? +\end_layout + +\begin_layout Standard +If there are any step-by-step instructions, you may want to include them + in an example so that they can be easily referred to later. +\end_layout + +\begin_layout Enumerate +Step One. + +\end_layout + +\begin_layout Enumerate +Step Two. + +\end_layout + +\begin_layout Enumerate +Step Three. + +\end_layout + +\begin_layout Section +Using SOFTWARE +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "using-softwarepackage" + +\end_inset + + +\end_layout + +\begin_layout Standard +Finally! Now you can describe how to use your system/software/package. +\end_layout + +\begin_layout Standard +APPENDIX +\end_layout + +\begin_layout Section +GNU Free Documentation License +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl" + +\end_inset + + +\end_layout + +\begin_layout Section +GNU Free Documentation License +\end_layout + +\begin_layout Standard +Version 1.1, March 2000 +\end_layout + +\begin_layout Quote +Copyright (C) 2000 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted + to copy and distribute verbatim copies of this license document, but changing + it is not allowed. + +\end_layout + +\begin_layout Section +PREAMBLE +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-0" + +\end_inset + + +\end_layout + +\begin_layout Standard +The purpose of this License is to make a manual, textbook, or other written + document ''free'' in the sense of freedom: to assure everyone the effective + freedom to copy and redistribute it, with or without modifying it, either + commercially or noncommercially. + Secondarily, this License preserves for the author and publisher a way + to get credit for their work, while not being considered responsible for + modifications made by others. +\end_layout + +\begin_layout Standard +This License is a kind of ''copyleft'', which means that derivative works + of the document must themselves be free in the same sense. + It complements the GNU General Public License, which is a copyleft license + designed for free software. +\end_layout + +\begin_layout Standard +We have designed this License in order to use it for manuals for free software, + because free software needs free documentation: a free program should come + with manuals providing the same freedoms that the software does. + But this License is not limited to software manuals; it can be used for + any textual work, regardless of subject matter or whether it is published + as a printed book. + We recommend this License principally for works whose purpose is instruction + or reference. +\end_layout + +\begin_layout Section +APPLICABILITY AND DEFINITIONS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-1" + +\end_inset + + +\end_layout + +\begin_layout Standard +This License applies to any manual or other work that contains a notice + placed by the copyright holder saying it can be distributed under the terms + of this License. + The ''Document'', below, refers to any such manual or work. + Any member of the public is a licensee, and is addressed as you''. +\end_layout + +\begin_layout Standard +A ''Modified Version'' of the Document means any work containing the Document + or a portion of it, either copied verbatim, or with modifications and/or + translated into another language. +\end_layout + +\begin_layout Standard +A ''Secondary Section'' is a named appendix or a front-matter section of + the Document that deals exclusively with the relationship of the publishers + or authors of the Document to the Document's overall subject (or to related + matters) and contains nothing that could fall directly within that overall + subject. + (For example, if the Document is in part a textbook of mathematics, a Secondary + Section may not explain any mathematics.) The relationship could be a matter + of historical connection with the subject or with related matters, or of + legal, commercial, philosophical, ethical or political position regarding + them. +\end_layout + +\begin_layout Standard +The ''Invariant Sections'' are certain Secondary Sections whose titles are + designated, as being those of Invariant Sections, in the notice that says + that the Document is released under this License. +\end_layout + +\begin_layout Standard +The ''Cover Texts'' are certain short passages of text that are listed, + as Front-Cover Texts or Back-Cover Texts, in the notice that says that + the Document is released under this License. +\end_layout + +\begin_layout Standard +A ''Transparent'' copy of the Document means a machine-readable copy, represente +d in a format whose specification is available to the general public, whose + contents can be viewed and edited directly and straightforwardly with generic + text editors or (for images composed of pixels) generic paint programs + or (for drawings) some widely available drawing editor, and that is suitable + for input to text formatters or for automatic translation to a variety + of formats suitable for input to text formatters. + A copy made in an otherwise Transparent file format whose markup has been + designed to thwart or discourage subsequent modification by readers is + not Transparent. + A copy that is not ''Transparent'' is called ''Opaque''. +\end_layout + +\begin_layout Standard +Examples of suitable formats for Transparent copies include plain ASCII + without markup, Texinfo input format, +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +LaTeX +\end_layout + +\end_inset + + input format, SGML or XML using a publicly available DTD, and standard-conformi +ng simple HTML designed for human modification. + Opaque formats include PostScript, PDF, proprietary formats that can be + read and edited only by proprietary word processors, SGML or XML for which + the DTD and/or processing tools are not generally available, and the machine-ge +nerated HTML produced by some word processors for output purposes only. +\end_layout + +\begin_layout Standard +The ''Title Page'' means, for a printed book, the title page itself, plus + such following pages as are needed to hold, legibly, the material this + License requires to appear in the title page. + For works in formats which do not have any title page as such, ''Title + Page'' means the text near the most prominent appearance of the work's + title, preceding the beginning of the body of the text. +\end_layout + +\begin_layout Section +VERBATIM COPYING +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-2" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may copy and distribute the Document in any medium, either commercially + or noncommercially, provided that this License, the copyright notices, + and the license notice saying this License applies to the Document are + reproduced in all copies, and that you add no other conditions whatsoever + to those of this License. + You may not use technical measures to obstruct or control the reading or + further copying of the copies you make or distribute. + However, you may accept compensation in exchange for copies. + If you distribute a large enough number of copies you must also follow + the conditions in section 3. +\end_layout + +\begin_layout Standard +You may also lend copies, under the same conditions stated above, and you + may publicly display copies. +\end_layout + +\begin_layout Section +COPYING IN QUANTITY +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-3" + +\end_inset + + +\end_layout + +\begin_layout Standard +If you publish printed copies of the Document numbering more than 100, and + the Document's license notice requires Cover Texts, you must enclose the + copies in covers that carry, clearly and legibly, all these Cover Texts: + Front-Cover Texts on the front cover, and Back-Cover Texts on the back + cover. + Both covers must also clearly and legibly identify you as the publisher + of these copies. + The front cover must present the full title with all words of the title + equally prominent and visible. + You may add other material on the covers in addition. + Copying with changes limited to the covers, as long as they preserve the + title of the Document and satisfy these conditions, can be treated as verbatim + copying in other respects. +\end_layout + +\begin_layout Standard +If the required texts for either cover are too voluminous to fit legibly, + you should put the first ones listed (as many as fit reasonably) on the + actual cover, and continue the rest onto adjacent pages. +\end_layout + +\begin_layout Standard +If you publish or distribute Opaque copies of the Document numbering more + than 100, you must either include a machine-readable Transparent copy along + with each Opaque copy, or state in or with each Opaque copy a publicly-accessib +le computer-network location containing a complete Transparent copy of the + Document, free of added material, which the general network-using public + has access to download anonymously at no charge using public-standard network + protocols. + If you use the latter option, you must take reasonably prudent steps, when + you begin distribution of Opaque copies in quantity, to ensure that this + Transparent copy will remain thus accessible at the stated location until + at least one year after the last time you distribute an Opaque copy (directly + or through your agents or retailers) of that edition to the public. +\end_layout + +\begin_layout Standard +It is requested, but not required, that you contact the authors of the Document + well before redistributing any large number of copies, to give them a chance + to provide you with an updated version of the Document. +\end_layout + +\begin_layout Section +MODIFICATIONS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-4" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may copy and distribute a Modified Version of the Document under the + conditions of sections 2 and 3 above, provided that you release the Modified + Version under precisely this License, with the Modified Version filling + the role of the Document, thus licensing distribution and modification + of the Modified Version to whoever possesses a copy of it. + In addition, you must do these things in the Modified Version: +\end_layout + +\begin_layout Standard +\begin_inset FormulaMacro +\newcommand{\labelenumi}{\Alph{enumi}.} +\end_inset + + +\end_layout + +\begin_layout Enumerate +Use in the Title Page (and on the covers, if any) a title distinct from + that of the Document, and from those of previous versions (which should, + if there were any, be listed in the History section of the Document). + You may use the same title as a previous version if the original publisher + of that version gives permission. + +\end_layout + +\begin_layout Enumerate +List on the Title Page, as authors, one or more persons or entities responsible + for authorship of the modifications in the Modified Version, together with + at least five of the principal authors of the Document (all of its principal + authors, if it has less than five). + +\end_layout + +\begin_layout Enumerate +State on the Title page the name of the publisher of the Modified Version, + as the publisher. + +\end_layout + +\begin_layout Enumerate +Preserve all the copyright notices of the Document. + +\end_layout + +\begin_layout Enumerate +Add an appropriate copyright notice for your modifications adjacent to the + other copyright notices. + +\end_layout + +\begin_layout Enumerate +Include, immediately after the copyright notices, a license notice giving + the public permission to use the Modified Version under the terms of this + License, in the form shown in the Addendum below. + +\end_layout + +\begin_layout Enumerate +Preserve in that license notice the full lists of Invariant Sections and + required Cover Texts given in the Document's license notice. + +\end_layout + +\begin_layout Enumerate +Include an unaltered copy of this License. + +\end_layout + +\begin_layout Enumerate +Preserve the section entitled ''History'', and its title, and add to it + an item stating at least the title, year, new authors, and publisher of + the Modified Version as given on the Title Page. + If there is no section entitled ''History'' in the Document, create one + stating the title, year, authors, and publisher of the Document as given + on its Title Page, then add an item describing the Modified Version as + stated in the previous sentence. + +\end_layout + +\begin_layout Enumerate +Preserve the network location, if any, given in the Document for public + access to a Transparent copy of the Document, and likewise the network + locations given in the Document for previous versions it was based on. + These may be placed in the ''History'' section. + You may omit a network location for a work that was published at least + four years before the Document itself, or if the original publisher of + the version it refers to gives permission. + +\end_layout + +\begin_layout Enumerate +In any section entitled ''Acknowledgements'' or ''Dedications'', preserve + the section's title, and preserve in the section all the substance and + tone of each of the contributor acknowledgements and/or dedications given + therein. + +\end_layout + +\begin_layout Enumerate +Preserve all the Invariant Sections of the Document, unaltered in their + text and in their titles. + Section numbers or the equivalent are not considered part of the section + titles. + +\end_layout + +\begin_layout Enumerate +Delete any section entitled ''Endorsements''. + Such a section may not be included in the Modified Version. + +\end_layout + +\begin_layout Enumerate +Do not retitle any existing section as ''Endorsements'' or to conflict in + title with any Invariant Section. + +\end_layout + +\begin_layout Standard +If the Modified Version includes new front-matter sections or appendices + that qualify as Secondary Sections and contain no material copied from + the Document, you may at your option designate some or all of these sections + as invariant. + To do this, add their titles to the list of Invariant Sections in the Modified + Version's license notice. + These titles must be distinct from any other section titles. +\end_layout + +\begin_layout Standard +You may add a section entitled ''Endorsements'', provided it contains nothing + but endorsements of your Modified Version by various parties- +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + + +\backslash +/ +\end_layout + +\end_inset + +-for example, statements of peer review or that the text has been approved + by an organization as the authoritative definition of a standard. +\end_layout + +\begin_layout Standard +You may add a passage of up to five words as a Front-Cover Text, and a passage + of up to 25 words as a Back-Cover Text, to the end of the list of Cover + Texts in the Modified Version. + Only one passage of Front-Cover Text and one of Back-Cover Text may be + added by (or through arrangements made by) any one entity. + If the Document already includes a cover text for the same cover, previously + added by you or by arrangement made by the same entity you are acting on + behalf of, you may not add another; but you may replace the old one, on + explicit permission from the previous publisher that added the old one. +\end_layout + +\begin_layout Standard +The author(s) and publisher(s) of the Document do not by this License give + permission to use their names for publicity for or to assert or imply endorseme +nt of any Modified Version. +\end_layout + +\begin_layout Section +COMBINING DOCUMENTS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-5" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may combine the Document with other documents released under this License, + under the terms defined in section 4 above for modified versions, provided + that you include in the combination all of the Invariant Sections of all + of the original documents, unmodified, and list them all as Invariant Sections + of your combined work in its license notice. +\end_layout + +\begin_layout Standard +The combined work need only contain one copy of this License, and multiple + identical Invariant Sections may be replaced with a single copy. + If there are multiple Invariant Sections with the same name but different + contents, make the title of each such section unique by adding at the end + of it, in parentheses, the name of the original author or publisher of + that section if known, or else a unique number. + Make the same adjustment to the section titles in the list of Invariant + Sections in the license notice of the combined work. +\end_layout + +\begin_layout Standard +In the combination, you must combine any sections entitled ''History'' in + the various original documents, forming one section entitled ''History''; + likewise combine any sections entitled ''Acknowledgements'', and any sections + entitled ''Dedications''. + You must delete all sections entitled ''Endorsements.'' +\end_layout + +\begin_layout Section +COLLECTIONS OF DOCUMENTS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-6" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may make a collection consisting of the Document and other documents + released under this License, and replace the individual copies of this + License in the various documents with a single copy that is included in + the collection, provided that you follow the rules of this License for + verbatim copying of each of the documents in all other respects. +\end_layout + +\begin_layout Standard +You may extract a single document from such a collection, and distribute + it individually under this License, provided you insert a copy of this + License into the extracted document, and follow this License in all other + respects regarding verbatim copying of that document. +\end_layout + +\begin_layout Section +AGGREGATION WITH INDEPENDENT WORKS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-7" + +\end_inset + + +\end_layout + +\begin_layout Standard +A compilation of the Document or its derivatives with other separate and + independent documents or works, in or on a volume of a storage or distribution + medium, does not as a whole count as a Modified Version of the Document, + provided no compilation copyright is claimed for the compilation. + Such a compilation is called an ''aggregate'', and this License does not + apply to the other self-contained works thus compiled with the Document, + on account of their being thus compiled, if they are not themselves derivative + works of the Document. +\end_layout + +\begin_layout Standard +If the Cover Text requirement of section 3 is applicable to these copies + of the Document, then if the Document is less than one quarter of the entire + aggregate, the Document's Cover Texts may be placed on covers that surround + only the Document within the aggregate. + Otherwise they must appear on covers around the whole aggregate. +\end_layout + +\begin_layout Section +TRANSLATION +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-8" + +\end_inset + + +\end_layout + +\begin_layout Standard +Translation is considered a kind of modification, so you may distribute + translations of the Document under the terms of section 4. + Replacing Invariant Sections with translations requires special permission + from their copyright holders, but you may include translations of some + or all Invariant Sections in addition to the original versions of these + Invariant Sections. + You may include a translation of this License provided that you also include + the original English version of this License. + In case of a disagreement between the translation and the original English + version of this License, the original English version will prevail. +\end_layout + +\begin_layout Section +TERMINATION +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-9" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may not copy, modify, sublicense, or distribute the Document except + as expressly provided for under this License. + Any other attempt to copy, modify, sublicense or distribute the Document + is void, and will automatically terminate your rights under this License. + However, parties who have received copies, or rights, from you under this + License will not have their licenses terminated so long as such parties + remain in full compliance. +\end_layout + +\begin_layout Section +FUTURE REVISIONS OF THIS LICENSE +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-10" + +\end_inset + + +\end_layout + +\begin_layout Standard +The Free Software Foundation may publish new, revised versions of the GNU + Free Documentation License from time to time. + Such new versions will be similar in spirit to the present version, but + may differ in detail to address new problems or concerns. + See +\begin_inset Flex Flex:URL +status collapsed + +\begin_layout Plain Layout + +http://www.gnu.org/copyleft/ +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Standard +Each version of the License is given a distinguishing version number. + If the Document specifies that a particular numbered version of this License + ''or any later version'' applies to it, you have the option of following + the terms and conditions either of that specified version or of any later + version that has been published (not as a draft) by the Free Software Foundatio +n. + If the Document does not specify a version number of this License, you + may choose any version ever published (not as a draft) by the Free Software + Foundation. +\end_layout + +\begin_layout Section +How to use this License for your documents +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-11" + +\end_inset + + +\end_layout + +\begin_layout Standard +To use this License in a document you have written, include a copy of the + License in the document and put the following copyright and license notices + just after the title page: +\end_layout + +\begin_layout Quote +Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation License, Version 1.1 or any later + version published by the Free Software Foundation; with the Invariant Sections + being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with + the Back-Cover Texts being LIST. + A copy of the license is included in the section entitled ''GNU Free Documentat +ion License''. + +\end_layout + +\begin_layout Standard +If you have no Invariant Sections, write ''with no Invariant Sections'' + instead of saying which ones are invariant. + If you have no Front-Cover Texts, write ''no Front-Cover Texts'' instead + of ''Front-Cover Texts being LIST''; likewise for Back-Cover Texts. +\end_layout + +\begin_layout Standard +If your document contains nontrivial examples of program code, we recommend + releasing these examples in parallel under your choice of free software + license, such as the GNU General Public License, to permit their use in + free software. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ new file mode 100644 index 00000000..1ec464f8 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ @@ -0,0 +1,1472 @@ +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +About this document +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "about" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Copyright and License +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "copyright" + +\end_inset + + +\end_layout + +\begin_layout Standard +Copyright (c) YEAR by YOUR NAME. +\end_layout + +\begin_layout Standard +Permission is granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation License, Version 1.1 or any later + version published by the Free Software Foundation; with no Invariant Sections, + no Front-Cover Texts, and with no Back-Cover Texts. + A copy of the license is included in ?. +\end_layout + +\begin_layout Subsection +Translations +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "translations" + +\end_inset + + +\end_layout + +\begin_layout Standard +If you know of any translations for this document, or you are interested + in translating it, please email me +\begin_inset CommandInset href +LatexCommand href +target "YOUR EMAIL" +type "mailto:" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Preface +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "preface" + +\end_inset + + +\end_layout + +\begin_layout Standard +Tell us why you decided to write this document. +\end_layout + +\begin_layout Subsection +Acknowledgments +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "thanks" + +\end_inset + + +\end_layout + +\begin_layout Standard +No one ever writes documentation by themselves. + Please take the time to thank the people who have helped you. +\end_layout + +\begin_layout Subsection +Feedback +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "feedback" + +\end_inset + + +\end_layout + +\begin_layout Standard +Find something wrong with this document? (Or perhaps something right?) I + would love to hear from you. + Please email me at +\begin_inset CommandInset href +LatexCommand href +target "YOUR EMAIL" +type "mailto:" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Conventions used in this document +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "conventions" + +\end_inset + + +\end_layout + +\begin_layout Standard +The following typographic and usage conventions occur in this text: +\end_layout + +\begin_layout Standard +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset Caption Standard + +\begin_layout Plain Layout +Typographic and usage conventions +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset Quotes eld +\end_inset + +Quoted text +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Quotes from people, quoted computer output. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +terminal view +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Literal computer input and output captured from the terminal. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +command +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Name of a command that can be entered on the command line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +option +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Option to a command, as in +\begin_inset Quotes eld +\end_inset + +the +\family typewriter +-a +\family default + option to the +\family typewriter +ls +\family default + command +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +parameter +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Parameter to a command, as in +\begin_inset Quotes eld +\end_inset + +read +\family typewriter +man +\begin_inset space \space{} +\end_inset + +ls +\family default + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +command +\begin_inset space \space{} +\end_inset + +options +\begin_inset space \space{} +\end_inset + +arguments +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Command synopsis or general usage, on a separated line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout + +\family typewriter +filename +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Name of a file or directory, for example +\begin_inset Quotes eld +\end_inset + +Change to the +\family typewriter +/usr/bin +\family default + directory. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{ +\end_layout + +\end_inset + +Menu +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{} +\end_layout + +\end_inset + + Choice +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +} +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Choice to select from a graphical menu, for instance: +\begin_inset Quotes eld +\end_inset + +Select +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{ +\end_layout + +\end_inset + +Help +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +{} +\end_layout + +\end_inset + + About Mozilla +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +} +\end_layout + +\end_inset + + in your browser. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Plain Layout +\begin_inset CommandInset href +LatexCommand href +name "The author" +target "http://www.xtrinsic.com" + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Plain Layout +Click-able link to an external web resource. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Standard +Thanks to Machtelt +\begin_inset Quotes eld +\end_inset + +Tille +\begin_inset Quotes erd +\end_inset + + Garrels for this list of conventions. +\end_layout + +\begin_layout Section +About My Topic +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "about" + +\end_inset + + +\end_layout + +\begin_layout Standard +Start by explaining the basics of your topic. + Is a brief history lesson in order? +\end_layout + +\begin_layout Subsection +Distribution News +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "distro-news" + +\end_inset + + +\end_layout + +\begin_layout Standard +If there is any news specific to each of the distrobutions of Linux, you + can include it here. +\end_layout + +\begin_layout Section +Installing from scratch +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "install" + +\end_inset + + +\end_layout + +\begin_layout Standard +Write down each of the steps on how to install any necessary packages/software/e +tc. + Do you need to recompile the kernel to activate new options? +\end_layout + +\begin_layout Standard +If there are any step-by-step instructions, you may want to include them + in an example so that they can be easily referred to later. +\end_layout + +\begin_layout Standard +\begin_inset FormulaMacro +\newcommand{\labelenumi}{\arabic{enumi}.} +\end_inset + + +\end_layout + +\begin_layout Enumerate +Step One. + +\end_layout + +\begin_layout Enumerate +Step Two. + +\end_layout + +\begin_layout Enumerate +Step Three. + +\end_layout + +\begin_layout Section +Using SOFTWARE +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "using-softwarepackage" + +\end_inset + + +\end_layout + +\begin_layout Standard +Finally! Now you can describe how to use your system/software/package. +\end_layout + +\begin_layout Standard +APPENDIX +\end_layout + +\begin_layout Section +GNU Free Documentation License +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl" + +\end_inset + + +\end_layout + +\begin_layout Section +GNU Free Documentation License +\end_layout + +\begin_layout Standard +Version 1.1, March 2000 +\end_layout + +\begin_layout Quote +Copyright (C) 2000 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted + to copy and distribute verbatim copies of this license document, but changing + it is not allowed. + +\end_layout + +\begin_layout Section +PREAMBLE +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-0" + +\end_inset + + +\end_layout + +\begin_layout Standard +The purpose of this License is to make a manual, textbook, or other written + document ''free'' in the sense of freedom: to assure everyone the effective + freedom to copy and redistribute it, with or without modifying it, either + commercially or noncommercially. + Secondarily, this License preserves for the author and publisher a way + to get credit for their work, while not being considered responsible for + modifications made by others. +\end_layout + +\begin_layout Standard +This License is a kind of ''copyleft'', which means that derivative works + of the document must themselves be free in the same sense. + It complements the GNU General Public License, which is a copyleft license + designed for free software. +\end_layout + +\begin_layout Standard +We have designed this License in order to use it for manuals for free software, + because free software needs free documentation: a free program should come + with manuals providing the same freedoms that the software does. + But this License is not limited to software manuals; it can be used for + any textual work, regardless of subject matter or whether it is published + as a printed book. + We recommend this License principally for works whose purpose is instruction + or reference. +\end_layout + +\begin_layout Section +APPLICABILITY AND DEFINITIONS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-1" + +\end_inset + + +\end_layout + +\begin_layout Standard +This License applies to any manual or other work that contains a notice + placed by the copyright holder saying it can be distributed under the terms + of this License. + The ''Document'', below, refers to any such manual or work. + Any member of the public is a licensee, and is addressed as you''. +\end_layout + +\begin_layout Standard +A ''Modified Version'' of the Document means any work containing the Document + or a portion of it, either copied verbatim, or with modifications and/or + translated into another language. +\end_layout + +\begin_layout Standard +A ''Secondary Section'' is a named appendix or a front-matter section of + the Document that deals exclusively with the relationship of the publishers + or authors of the Document to the Document's overall subject (or to related + matters) and contains nothing that could fall directly within that overall + subject. + (For example, if the Document is in part a textbook of mathematics, a Secondary + Section may not explain any mathematics.) The relationship could be a matter + of historical connection with the subject or with related matters, or of + legal, commercial, philosophical, ethical or political position regarding + them. +\end_layout + +\begin_layout Standard +The ''Invariant Sections'' are certain Secondary Sections whose titles are + designated, as being those of Invariant Sections, in the notice that says + that the Document is released under this License. +\end_layout + +\begin_layout Standard +The ''Cover Texts'' are certain short passages of text that are listed, + as Front-Cover Texts or Back-Cover Texts, in the notice that says that + the Document is released under this License. +\end_layout + +\begin_layout Standard +A ''Transparent'' copy of the Document means a machine-readable copy, represente +d in a format whose specification is available to the general public, whose + contents can be viewed and edited directly and straightforwardly with generic + text editors or (for images composed of pixels) generic paint programs + or (for drawings) some widely available drawing editor, and that is suitable + for input to text formatters or for automatic translation to a variety + of formats suitable for input to text formatters. + A copy made in an otherwise Transparent file format whose markup has been + designed to thwart or discourage subsequent modification by readers is + not Transparent. + A copy that is not ''Transparent'' is called ''Opaque''. +\end_layout + +\begin_layout Standard +Examples of suitable formats for Transparent copies include plain ASCII + without markup, Texinfo input format, +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +LaTeX +\end_layout + +\end_inset + + input format, SGML or XML using a publicly available DTD, and standard-conformi +ng simple HTML designed for human modification. + Opaque formats include PostScript, PDF, proprietary formats that can be + read and edited only by proprietary word processors, SGML or XML for which + the DTD and/or processing tools are not generally available, and the machine-ge +nerated HTML produced by some word processors for output purposes only. +\end_layout + +\begin_layout Standard +The ''Title Page'' means, for a printed book, the title page itself, plus + such following pages as are needed to hold, legibly, the material this + License requires to appear in the title page. + For works in formats which do not have any title page as such, ''Title + Page'' means the text near the most prominent appearance of the work's + title, preceding the beginning of the body of the text. +\end_layout + +\begin_layout Section +VERBATIM COPYING +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-2" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may copy and distribute the Document in any medium, either commercially + or noncommercially, provided that this License, the copyright notices, + and the license notice saying this License applies to the Document are + reproduced in all copies, and that you add no other conditions whatsoever + to those of this License. + You may not use technical measures to obstruct or control the reading or + further copying of the copies you make or distribute. + However, you may accept compensation in exchange for copies. + If you distribute a large enough number of copies you must also follow + the conditions in section 3. +\end_layout + +\begin_layout Standard +You may also lend copies, under the same conditions stated above, and you + may publicly display copies. +\end_layout + +\begin_layout Section +COPYING IN QUANTITY +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-3" + +\end_inset + + +\end_layout + +\begin_layout Standard +If you publish printed copies of the Document numbering more than 100, and + the Document's license notice requires Cover Texts, you must enclose the + copies in covers that carry, clearly and legibly, all these Cover Texts: + Front-Cover Texts on the front cover, and Back-Cover Texts on the back + cover. + Both covers must also clearly and legibly identify you as the publisher + of these copies. + The front cover must present the full title with all words of the title + equally prominent and visible. + You may add other material on the covers in addition. + Copying with changes limited to the covers, as long as they preserve the + title of the Document and satisfy these conditions, can be treated as verbatim + copying in other respects. +\end_layout + +\begin_layout Standard +If the required texts for either cover are too voluminous to fit legibly, + you should put the first ones listed (as many as fit reasonably) on the + actual cover, and continue the rest onto adjacent pages. +\end_layout + +\begin_layout Standard +If you publish or distribute Opaque copies of the Document numbering more + than 100, you must either include a machine-readable Transparent copy along + with each Opaque copy, or state in or with each Opaque copy a publicly-accessib +le computer-network location containing a complete Transparent copy of the + Document, free of added material, which the general network-using public + has access to download anonymously at no charge using public-standard network + protocols. + If you use the latter option, you must take reasonably prudent steps, when + you begin distribution of Opaque copies in quantity, to ensure that this + Transparent copy will remain thus accessible at the stated location until + at least one year after the last time you distribute an Opaque copy (directly + or through your agents or retailers) of that edition to the public. +\end_layout + +\begin_layout Standard +It is requested, but not required, that you contact the authors of the Document + well before redistributing any large number of copies, to give them a chance + to provide you with an updated version of the Document. +\end_layout + +\begin_layout Section +MODIFICATIONS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-4" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may copy and distribute a Modified Version of the Document under the + conditions of sections 2 and 3 above, provided that you release the Modified + Version under precisely this License, with the Modified Version filling + the role of the Document, thus licensing distribution and modification + of the Modified Version to whoever possesses a copy of it. + In addition, you must do these things in the Modified Version: +\end_layout + +\begin_layout Standard +\begin_inset FormulaMacro +\renewcommand{\labelenumi}{\Alph{enumi}.} +\end_inset + + +\end_layout + +\begin_layout Enumerate +Use in the Title Page (and on the covers, if any) a title distinct from + that of the Document, and from those of previous versions (which should, + if there were any, be listed in the History section of the Document). + You may use the same title as a previous version if the original publisher + of that version gives permission. + +\end_layout + +\begin_layout Enumerate +List on the Title Page, as authors, one or more persons or entities responsible + for authorship of the modifications in the Modified Version, together with + at least five of the principal authors of the Document (all of its principal + authors, if it has less than five). + +\end_layout + +\begin_layout Enumerate +State on the Title page the name of the publisher of the Modified Version, + as the publisher. + +\end_layout + +\begin_layout Enumerate +Preserve all the copyright notices of the Document. + +\end_layout + +\begin_layout Enumerate +Add an appropriate copyright notice for your modifications adjacent to the + other copyright notices. + +\end_layout + +\begin_layout Enumerate +Include, immediately after the copyright notices, a license notice giving + the public permission to use the Modified Version under the terms of this + License, in the form shown in the Addendum below. + +\end_layout + +\begin_layout Enumerate +Preserve in that license notice the full lists of Invariant Sections and + required Cover Texts given in the Document's license notice. + +\end_layout + +\begin_layout Enumerate +Include an unaltered copy of this License. + +\end_layout + +\begin_layout Enumerate +Preserve the section entitled ''History'', and its title, and add to it + an item stating at least the title, year, new authors, and publisher of + the Modified Version as given on the Title Page. + If there is no section entitled ''History'' in the Document, create one + stating the title, year, authors, and publisher of the Document as given + on its Title Page, then add an item describing the Modified Version as + stated in the previous sentence. + +\end_layout + +\begin_layout Enumerate +Preserve the network location, if any, given in the Document for public + access to a Transparent copy of the Document, and likewise the network + locations given in the Document for previous versions it was based on. + These may be placed in the ''History'' section. + You may omit a network location for a work that was published at least + four years before the Document itself, or if the original publisher of + the version it refers to gives permission. + +\end_layout + +\begin_layout Enumerate +In any section entitled ''Acknowledgements'' or ''Dedications'', preserve + the section's title, and preserve in the section all the substance and + tone of each of the contributor acknowledgements and/or dedications given + therein. + +\end_layout + +\begin_layout Enumerate +Preserve all the Invariant Sections of the Document, unaltered in their + text and in their titles. + Section numbers or the equivalent are not considered part of the section + titles. + +\end_layout + +\begin_layout Enumerate +Delete any section entitled ''Endorsements''. + Such a section may not be included in the Modified Version. + +\end_layout + +\begin_layout Enumerate +Do not retitle any existing section as ''Endorsements'' or to conflict in + title with any Invariant Section. + +\end_layout + +\begin_layout Standard +If the Modified Version includes new front-matter sections or appendices + that qualify as Secondary Sections and contain no material copied from + the Document, you may at your option designate some or all of these sections + as invariant. + To do this, add their titles to the list of Invariant Sections in the Modified + Version's license notice. + These titles must be distinct from any other section titles. +\end_layout + +\begin_layout Standard +You may add a section entitled ''Endorsements'', provided it contains nothing + but endorsements of your Modified Version by various parties- +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + + +\backslash +/ +\end_layout + +\end_inset + +-for example, statements of peer review or that the text has been approved + by an organization as the authoritative definition of a standard. +\end_layout + +\begin_layout Standard +You may add a passage of up to five words as a Front-Cover Text, and a passage + of up to 25 words as a Back-Cover Text, to the end of the list of Cover + Texts in the Modified Version. + Only one passage of Front-Cover Text and one of Back-Cover Text may be + added by (or through arrangements made by) any one entity. + If the Document already includes a cover text for the same cover, previously + added by you or by arrangement made by the same entity you are acting on + behalf of, you may not add another; but you may replace the old one, on + explicit permission from the previous publisher that added the old one. +\end_layout + +\begin_layout Standard +The author(s) and publisher(s) of the Document do not by this License give + permission to use their names for publicity for or to assert or imply endorseme +nt of any Modified Version. +\end_layout + +\begin_layout Section +COMBINING DOCUMENTS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-5" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may combine the Document with other documents released under this License, + under the terms defined in section 4 above for modified versions, provided + that you include in the combination all of the Invariant Sections of all + of the original documents, unmodified, and list them all as Invariant Sections + of your combined work in its license notice. +\end_layout + +\begin_layout Standard +The combined work need only contain one copy of this License, and multiple + identical Invariant Sections may be replaced with a single copy. + If there are multiple Invariant Sections with the same name but different + contents, make the title of each such section unique by adding at the end + of it, in parentheses, the name of the original author or publisher of + that section if known, or else a unique number. + Make the same adjustment to the section titles in the list of Invariant + Sections in the license notice of the combined work. +\end_layout + +\begin_layout Standard +In the combination, you must combine any sections entitled ''History'' in + the various original documents, forming one section entitled ''History''; + likewise combine any sections entitled ''Acknowledgements'', and any sections + entitled ''Dedications''. + You must delete all sections entitled ''Endorsements.'' +\end_layout + +\begin_layout Section +COLLECTIONS OF DOCUMENTS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-6" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may make a collection consisting of the Document and other documents + released under this License, and replace the individual copies of this + License in the various documents with a single copy that is included in + the collection, provided that you follow the rules of this License for + verbatim copying of each of the documents in all other respects. +\end_layout + +\begin_layout Standard +You may extract a single document from such a collection, and distribute + it individually under this License, provided you insert a copy of this + License into the extracted document, and follow this License in all other + respects regarding verbatim copying of that document. +\end_layout + +\begin_layout Section +AGGREGATION WITH INDEPENDENT WORKS +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-7" + +\end_inset + + +\end_layout + +\begin_layout Standard +A compilation of the Document or its derivatives with other separate and + independent documents or works, in or on a volume of a storage or distribution + medium, does not as a whole count as a Modified Version of the Document, + provided no compilation copyright is claimed for the compilation. + Such a compilation is called an ''aggregate'', and this License does not + apply to the other self-contained works thus compiled with the Document, + on account of their being thus compiled, if they are not themselves derivative + works of the Document. +\end_layout + +\begin_layout Standard +If the Cover Text requirement of section 3 is applicable to these copies + of the Document, then if the Document is less than one quarter of the entire + aggregate, the Document's Cover Texts may be placed on covers that surround + only the Document within the aggregate. + Otherwise they must appear on covers around the whole aggregate. +\end_layout + +\begin_layout Section +TRANSLATION +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-8" + +\end_inset + + +\end_layout + +\begin_layout Standard +Translation is considered a kind of modification, so you may distribute + translations of the Document under the terms of section 4. + Replacing Invariant Sections with translations requires special permission + from their copyright holders, but you may include translations of some + or all Invariant Sections in addition to the original versions of these + Invariant Sections. + You may include a translation of this License provided that you also include + the original English version of this License. + In case of a disagreement between the translation and the original English + version of this License, the original English version will prevail. +\end_layout + +\begin_layout Section +TERMINATION +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-9" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may not copy, modify, sublicense, or distribute the Document except + as expressly provided for under this License. + Any other attempt to copy, modify, sublicense or distribute the Document + is void, and will automatically terminate your rights under this License. + However, parties who have received copies, or rights, from you under this + License will not have their licenses terminated so long as such parties + remain in full compliance. +\end_layout + +\begin_layout Section +FUTURE REVISIONS OF THIS LICENSE +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-10" + +\end_inset + + +\end_layout + +\begin_layout Standard +The Free Software Foundation may publish new, revised versions of the GNU + Free Documentation License from time to time. + Such new versions will be similar in spirit to the present version, but + may differ in detail to address new problems or concerns. + See +\begin_inset Flex Flex:URL +status collapsed + +\begin_layout Plain Layout + +http://www.gnu.org/copyleft/ +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Standard +Each version of the License is given a distinguishing version number. + If the Document specifies that a particular numbered version of this License + ''or any later version'' applies to it, you have the option of following + the terms and conditions either of that specified version or of any later + version that has been published (not as a draft) by the Free Software Foundatio +n. + If the Document does not specify a version number of this License, you + may choose any version ever published (not as a draft) by the Free Software + Foundation. +\end_layout + +\begin_layout Section +How to use this License for your documents +\end_layout + +\begin_layout Standard +\begin_inset CommandInset label +LatexCommand label +name "gfdl-11" + +\end_inset + + +\end_layout + +\begin_layout Standard +To use this License in a document you have written, include a copy of the + License in the document and put the following copyright and license notices + just after the title page: +\end_layout + +\begin_layout Quote +Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document under + the terms of the GNU Free Documentation License, Version 1.1 or any later + version published by the Free Software Foundation; with the Invariant Sections + being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with + the Back-Cover Texts being LIST. + A copy of the license is included in the section entitled ''GNU Free Documentat +ion License''. + +\end_layout + +\begin_layout Standard +If you have no Invariant Sections, write ''with no Invariant Sections'' + instead of saying which ones are invariant. + If you have no Front-Cover Texts, write ''no Front-Cover Texts'' instead + of ''Front-Cover Texts being LIST''; likewise for Back-Cover Texts. +\end_layout + +\begin_layout Standard +If your document contains nontrivial examples of program code, we recommend + releasing these examples in parallel under your choice of free software + license, such as the GNU General Public License, to permit their use in + free software. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml new file mode 100644 index 00000000..7947a423 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml @@ -0,0 +1,722 @@ + + + + + + + + + + + + + +]> + +
+ +Sample XML HOWTO + + + Your Given Name + Your Family Name (Surname) + A short sentence about who you are. + + + + company name + + + +
+ youremail@domain.NOSPAM.org +
+ + + + +YYYY-MM-DD + + + + This is a sample DocBook XML HOWTO which you may use as a document template. + + + + + + 1.1 + 2005-03-04 + ME + A short note about what you have changed. + + + 1.0 + YYYY-MM-DD + ME + First official release. + + + + + + + +About this document + + + +Copyright and License + + Copyright (c) YEAR by YOUR NAME. + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU Free Documentation License, Version + 1.1 or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and with no Back-Cover + Texts. + A copy of the license is included in . + + + + + + +Translations + + + + +If you know of any translations for this document, or you are interested in translating it, please email me YOUR EMAIL. + + + +Preface + Tell us why you decided to write this document. + + + +Acknowledgments +No one ever writes documentation by themselves. Please take the time to thank the people who have helped you. + + + + + + + +Feedback + Find something wrong with this document? (Or perhaps something right?) I would love to hear from you. Please email me at YOUR EMAIL. + + + +Conventions used in this document + +The following typographic and usage conventions occur in this text: + + + +Typographic and usage conventions + + + +Text typeMeaning + + + + +Quoted text +Quotes from people, quoted computer output. + + +terminal view +Literal computer input and output captured from the terminal. + + +command +Name of a command that can be entered on the command line. + + + +Option to a command, as in the option to the +ls command. + + +parameter +Parameter to a command, as in read +man ls. + + +command +arguments +Command synopsis or general usage, on a separated line. + + +filename +Name of a file or directory, for example Change to the +/usr/bin directory. + + +MenuChoice + +Choice to select from a graphical menu, for instance: Select +HelpAbout Mozilla + in your browser. + + +The author +Click-able link to an external web resource. + + + + +
+ +Thanks to Machtelt Tille Garrels for this list of conventions. + + + + + +About My Topic + +Start by explaining the basics of your topic. Is a brief history lesson in order? + + +Distribution News +If there is any news specific to each of the distrobutions of Linux, you can include it here. + + + + + +Installing from scratch +Write down each of the steps on how to install any necessary packages/software/etc. Do you need to recompile the kernel to activate new options? + +If there are any step-by-step instructions, you may want to include them in an example so that they can be easily referred to later. + + +Installation Instructions + + Step One. + Step Two. + Step Three. + + + + + + + +Using SOFTWARE +Finally! Now you can describe how to use your system/software/package. + + + +&appendix; + + + +GNU Free Documentation License + + + + + + GNU Free Documentation License + + Version 1.1, March 2000 + +
+ Copyright (C) 2000 Free Software Foundation, Inc. +59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +Everyone is permitted to copy and distribute verbatim copies +of this license document, but changing it is not allowed. +
+ + + + PREAMBLE + + The purpose of this License is to make a manual, textbook, + or other written document "free" in the sense of freedom: to + assure everyone the effective freedom to copy and redistribute it, + with or without modifying it, either commercially or + noncommercially. Secondarily, this License preserves for the + author and publisher a way to get credit for their work, while not + being considered responsible for modifications made by + others. + + This License is a kind of "copyleft", which means that + derivative works of the document must themselves be free in the + same sense. It complements the GNU General Public License, which + is a copyleft license designed for free software. + + We have designed this License in order to use it for manuals + for free software, because free software needs free documentation: + a free program should come with manuals providing the same + freedoms that the software does. But this License is not limited + to software manuals; it can be used for any textual work, + regardless of subject matter or whether it is published as a + printed book. We recommend this License principally for works + whose purpose is instruction or reference. + + + + APPLICABILITY AND DEFINITIONS + + This License applies to any manual or other work that + contains a notice placed by the copyright holder saying it can be + distributed under the terms of this License. The "Document", + below, refers to any such manual or work. Any member of the + public is a licensee, and is addressed as "you". + + A "Modified Version" of the Document means any work + containing the Document or a portion of it, either copied + verbatim, or with modifications and/or translated into another + language. + + A "Secondary Section" is a named appendix or a front-matter + section of the Document that deals exclusively with the + relationship of the publishers or authors of the Document to the + Document's overall subject (or to related matters) and contains + nothing that could fall directly within that overall subject. + (For example, if the Document is in part a textbook of + mathematics, a Secondary Section may not explain any mathematics.) + The relationship could be a matter of historical connection with + the subject or with related matters, or of legal, commercial, + philosophical, ethical or political position regarding + them. + + The "Invariant Sections" are certain Secondary Sections + whose titles are designated, as being those of Invariant Sections, + in the notice that says that the Document is released under this + License. + + The "Cover Texts" are certain short passages of text that + are listed, as Front-Cover Texts or Back-Cover Texts, in the + notice that says that the Document is released under this + License. + + A "Transparent" copy of the Document means a + machine-readable copy, represented in a format whose specification + is available to the general public, whose contents can be viewed + and edited directly and straightforwardly with generic text + editors or (for images composed of pixels) generic paint programs + or (for drawings) some widely available drawing editor, and that + is suitable for input to text formatters or for automatic + translation to a variety of formats suitable for input to text + formatters. A copy made in an otherwise Transparent file format + whose markup has been designed to thwart or discourage subsequent + modification by readers is not Transparent. A copy that is not + "Transparent" is called "Opaque". + + Examples of suitable formats for Transparent copies include + plain ASCII without markup, Texinfo input format, LaTeX input + format, SGML or XML using a publicly available DTD, and + standard-conforming simple HTML designed for human modification. + Opaque formats include PostScript, PDF, proprietary formats that + can be read and edited only by proprietary word processors, SGML + or XML for which the DTD and/or processing tools are not generally + available, and the machine-generated HTML produced by some word + processors for output purposes only. + + The "Title Page" means, for a printed book, the title page + itself, plus such following pages as are needed to hold, legibly, + the material this License requires to appear in the title page. + For works in formats which do not have any title page as such, + "Title Page" means the text near the most prominent appearance of + the work's title, preceding the beginning of the body of the + text. + + + + VERBATIM COPYING + + You may copy and distribute the Document in any medium, + either commercially or noncommercially, provided that this + License, the copyright notices, and the license notice saying this + License applies to the Document are reproduced in all copies, and + that you add no other conditions whatsoever to those of this + License. You may not use technical measures to obstruct or + control the reading or further copying of the copies you make or + distribute. However, you may accept compensation in exchange for + copies. If you distribute a large enough number of copies you + must also follow the conditions in section 3. + + You may also lend copies, under the same conditions stated + above, and you may publicly display copies. + + + + COPYING IN QUANTITY + + If you publish printed copies of the Document numbering more + than 100, and the Document's license notice requires Cover Texts, + you must enclose the copies in covers that carry, clearly and + legibly, all these Cover Texts: Front-Cover Texts on the front + cover, and Back-Cover Texts on the back cover. Both covers must + also clearly and legibly identify you as the publisher of these + copies. The front cover must present the full title with all + words of the title equally prominent and visible. You may add + other material on the covers in addition. Copying with changes + limited to the covers, as long as they preserve the title of the + Document and satisfy these conditions, can be treated as verbatim + copying in other respects. + + If the required texts for either cover are too voluminous to + fit legibly, you should put the first ones listed (as many as fit + reasonably) on the actual cover, and continue the rest onto + adjacent pages. + + If you publish or distribute Opaque copies of the Document + numbering more than 100, you must either include a + machine-readable Transparent copy along with each Opaque copy, or + state in or with each Opaque copy a publicly-accessible + computer-network location containing a complete Transparent copy + of the Document, free of added material, which the general + network-using public has access to download anonymously at no + charge using public-standard network protocols. If you use the + latter option, you must take reasonably prudent steps, when you + begin distribution of Opaque copies in quantity, to ensure that + this Transparent copy will remain thus accessible at the stated + location until at least one year after the last time you + distribute an Opaque copy (directly or through your agents or + retailers) of that edition to the public. + + It is requested, but not required, that you contact the + authors of the Document well before redistributing any large + number of copies, to give them a chance to provide you with an + updated version of the Document. + + + + MODIFICATIONS + + You may copy and distribute a Modified Version of the + Document under the conditions of sections 2 and 3 above, provided + that you release the Modified Version under precisely this + License, with the Modified Version filling the role of the + Document, thus licensing distribution and modification of the + Modified Version to whoever possesses a copy of it. In addition, + you must do these things in the Modified Version: + + + Use in the Title Page + (and on the covers, if any) a title distinct from that of the + Document, and from those of previous versions (which should, if + there were any, be listed in the History section of the + Document). You may use the same title as a previous version if + the original publisher of that version gives permission. + + + List on the Title Page, + as authors, one or more persons or entities responsible for + authorship of the modifications in the Modified Version, + together with at least five of the principal authors of the + Document (all of its principal authors, if it has less than + five). + + + State on the Title page + the name of the publisher of the Modified Version, as the + publisher. + + + Preserve all the + copyright notices of the Document. + + + Add an appropriate + copyright notice for your modifications adjacent to the other + copyright notices. + + + Include, immediately + after the copyright notices, a license notice giving the public + permission to use the Modified Version under the terms of this + License, in the form shown in the Addendum below. + + + Preserve in that license + notice the full lists of Invariant Sections and required Cover + Texts given in the Document's license notice. + + + Include an unaltered + copy of this License. + + + Preserve the section + entitled "History", and its title, and add to it an item stating + at least the title, year, new authors, and publisher of the + Modified Version as given on the Title Page. If there is no + section entitled "History" in the Document, create one stating + the title, year, authors, and publisher of the Document as given + on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. + + + Preserve the network + location, if any, given in the Document for public access to a + Transparent copy of the Document, and likewise the network + locations given in the Document for previous versions it was + based on. These may be placed in the "History" section. You + may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. + + + In any section entitled + "Acknowledgements" or "Dedications", preserve the section's + title, and preserve in the section all the substance and tone of + each of the contributor acknowledgements and/or dedications + given therein. + + + Preserve all the + Invariant Sections of the Document, unaltered in their text and + in their titles. Section numbers or the equivalent are not + considered part of the section titles. + + + Delete any section + entitled "Endorsements". Such a section may not be included in + the Modified Version. + + + Do not retitle any + existing section as "Endorsements" or to conflict in title with + any Invariant Section. + + + + If the Modified Version includes new front-matter sections + or appendices that qualify as Secondary Sections and contain no + material copied from the Document, you may at your option + designate some or all of these sections as invariant. To do this, + add their titles to the list of Invariant Sections in the Modified + Version's license notice. These titles must be distinct from any + other section titles. + + You may add a section entitled "Endorsements", provided it + contains nothing but endorsements of your Modified Version by + various parties--for example, statements of peer review or that + the text has been approved by an organization as the authoritative + definition of a standard. + + You may add a passage of up to five words as a Front-Cover + Text, and a passage of up to 25 words as a Back-Cover Text, to the + end of the list of Cover Texts in the Modified Version. Only one + passage of Front-Cover Text and one of Back-Cover Text may be + added by (or through arrangements made by) any one entity. If the + Document already includes a cover text for the same cover, + previously added by you or by arrangement made by the same entity + you are acting on behalf of, you may not add another; but you may + replace the old one, on explicit permission from the previous + publisher that added the old one. + + The author(s) and publisher(s) of the Document do not by + this License give permission to use their names for publicity for + or to assert or imply endorsement of any Modified Version. + + + + COMBINING DOCUMENTS + + You may combine the Document with other documents released + under this License, under the terms defined in section 4 above for + modified versions, provided that you include in the combination + all of the Invariant Sections of all of the original documents, + unmodified, and list them all as Invariant Sections of your + combined work in its license notice. + + The combined work need only contain one copy of this + License, and multiple identical Invariant Sections may be replaced + with a single copy. If there are multiple Invariant Sections with + the same name but different contents, make the title of each such + section unique by adding at the end of it, in parentheses, the + name of the original author or publisher of that section if known, + or else a unique number. Make the same adjustment to the section + titles in the list of Invariant Sections in the license notice of + the combined work. + + In the combination, you must combine any sections entitled + "History" in the various original documents, forming one section + entitled "History"; likewise combine any sections entitled + "Acknowledgements", and any sections entitled "Dedications". You + must delete all sections entitled "Endorsements." + + + + COLLECTIONS OF DOCUMENTS + + You may make a collection consisting of the Document and + other documents released under this License, and replace the + individual copies of this License in the various documents with a + single copy that is included in the collection, provided that you + follow the rules of this License for verbatim copying of each of + the documents in all other respects. + + You may extract a single document from such a collection, + and distribute it individually under this License, provided you + insert a copy of this License into the extracted document, and + follow this License in all other respects regarding verbatim + copying of that document. + + + + AGGREGATION WITH INDEPENDENT WORKS + + A compilation of the Document or its derivatives with other + separate and independent documents or works, in or on a volume of + a storage or distribution medium, does not as a whole count as a + Modified Version of the Document, provided no compilation + copyright is claimed for the compilation. Such a compilation is + called an "aggregate", and this License does not apply to the + other self-contained works thus compiled with the Document, on + account of their being thus compiled, if they are not themselves + derivative works of the Document. + + If the Cover Text requirement of section 3 is applicable to + these copies of the Document, then if the Document is less than + one quarter of the entire aggregate, the Document's Cover Texts + may be placed on covers that surround only the Document within the + aggregate. Otherwise they must appear on covers around the whole + aggregate. + + + + TRANSLATION + + Translation is considered a kind of modification, so you may + distribute translations of the Document under the terms of section + 4. Replacing Invariant Sections with translations requires + special permission from their copyright holders, but you may + include translations of some or all Invariant Sections in addition + to the original versions of these Invariant Sections. You may + include a translation of this License provided that you also + include the original English version of this License. In case of + a disagreement between the translation and the original English + version of this License, the original English version will + prevail. + + + + TERMINATION + + You may not copy, modify, sublicense, or distribute the + Document except as expressly provided for under this License. Any + other attempt to copy, modify, sublicense or distribute the + Document is void, and will automatically terminate your rights + under this License. However, parties who have received copies, or + rights, from you under this License will not have their licenses + terminated so long as such parties remain in full + compliance. + + + + FUTURE REVISIONS OF THIS LICENSE + + The Free Software Foundation may publish new, revised + versions of the GNU Free Documentation License from time to time. + Such new versions will be similar in spirit to the present + version, but may differ in detail to address new problems or + concerns. See http://www.gnu.org/copyleft/. + + Each version of the License is given a distinguishing + version number. If the Document specifies that a particular + numbered version of this License "or any later version" applies to + it, you have the option of following the terms and conditions + either of that specified version or of any later version that has + been published (not as a draft) by the Free Software Foundation. + If the Document does not specify a version number of this License, + you may choose any version ever published (not as a draft) by the + Free Software Foundation. + + + + How to use this License for your documents + + To use this License in a document you have written, include + a copy of the License in the document and put the following + copyright and license notices just after the title page: + +
+ Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.1 + or any later version published by the Free Software Foundation; + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + A copy of the license is included in the section entitled "GNU + Free Documentation License". +
+ + If you have no Invariant Sections, write "with no Invariant + Sections" instead of saying which ones are invariant. If you have + no Front-Cover Texts, write "no Front-Cover Texts" instead of + "Front-Cover Texts being LIST"; likewise for Back-Cover + Texts. + + If your document contains nontrivial examples of program + code, we recommend releasing these examples in parallel under your + choice of free software license, such as the GNU General Public + License, to permit their use in free software. + + + + + + + + + +
diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.lyx b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.lyx new file mode 100644 index 00000000..4e2a7fe2 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.lyx @@ -0,0 +1,1237 @@ +#LyX file created by tex2lyx 2.1 +\lyxformat 474 +\begin_document +\begin_header +\textclass article +\use_default_options false +\maintain_unincluded_children false +\language english +\language_package none +\inputencoding auto +\fontencoding default +\font_roman default +\font_sans default +\font_typewriter default +\font_math auto +\font_default_family default +\use_non_tex_fonts false +\font_sc false +\font_osf false +\font_sf_scale 100 +\font_tt_scale 100 +\graphics default +\default_output_format default +\output_sync 0 +\bibtex_command default +\index_command default +\paperfontsize default +\spacing single +\use_hyperref false +\papersize default +\use_geometry false +\use_package amsmath 1 +\use_package amssymb 0 +\use_package cancel 0 +\use_package esint 1 +\use_package mathdots 0 +\use_package mathtools 0 +\use_package mhchem 0 +\use_package stackrel 0 +\use_package stmaryrd 0 +\use_package undertilde 0 +\cite_engine basic +\cite_engine_type default +\biblio_style plain +\use_bibtopic false +\use_indices false +\paperorientation portrait +\suppress_date false +\justification true +\use_refstyle 0 +\index Index +\shortcut idx +\color #008000 +\end_index +\secnumdepth 3 +\tocdepth 3 +\paragraph_separation indent +\paragraph_indentation default +\quotes_language english +\papercolumns 1 +\papersides 1 +\paperpagestyle default +\tracking_changes false +\output_changes false +\html_math_output 0 +\html_css_as_file 0 +\html_be_strict false +\end_header + +\begin_body + +\begin_layout Section +About this document +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "about" + +\end_inset + + +\end_layout + +\begin_layout Subsection +Copyright and License +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "copyright" + +\end_inset + + +\end_layout + +\begin_layout Standard +Copyright (c) YEAR by YOUR NAME. +\end_layout + +\begin_layout Standard +Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in ?. +\end_layout + +\begin_layout Subsection +Translations +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "translations" + +\end_inset + + +\end_layout + +\begin_layout Standard +If you know of any translations for this document, or you are interested in translating it, please email me +\begin_inset CommandInset href +LatexCommand href +target "YOUR EMAIL" +type "mailto:" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Preface +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "preface" + +\end_inset + + +\end_layout + +\begin_layout Standard +Tell us why you decided to write this document. +\end_layout + +\begin_layout Subsection +Acknowledgments +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "thanks" + +\end_inset + + +\end_layout + +\begin_layout Standard +No one ever writes documentation by themselves. Please take the time to thank the people who have helped you. +\end_layout + +\begin_layout Subsection +Feedback +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "feedback" + +\end_inset + + +\end_layout + +\begin_layout Standard +Find something wrong with this document? (Or perhaps something right?) I would love to hear from you. Please email me at +\begin_inset CommandInset href +LatexCommand href +target "YOUR EMAIL" +type "mailto:" + +\end_inset + +. +\end_layout + +\begin_layout Subsection +Conventions used in this document +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "conventions" + +\end_inset + + +\end_layout + +\begin_layout Standard +The following typographic and usage conventions occur in this text: +\end_layout + +\begin_layout Standard + +\begin_inset Tabular + + + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset Caption Standard + +\begin_layout Plain Layout +Typographic and usage conventions +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard +Text type +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Meaning +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset Quotes eld +\end_inset + +Quoted text +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Quotes from people, quoted computer output. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Verbatim +terminal view +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Literal computer input and output captured from the terminal. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +command +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Name of a command that can be entered on the command line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +option +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Option to a command, as in +\begin_inset Quotes eld +\end_inset + +the +\family typewriter +-a +\family default + option to the +\family typewriter +ls +\family default + command +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +parameter +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Parameter to a command, as in +\begin_inset Quotes eld +\end_inset + +read +\family typewriter +man +\begin_inset space \space{} + +\end_inset + +ls +\family default + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +command +\begin_inset space \space{} + +\end_inset + +options +\begin_inset space \space{} + +\end_inset + +arguments +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Command synopsis or general usage, on a separated line. +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\family typewriter +filename +\family default + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Name of a file or directory, for example +\begin_inset Quotes eld +\end_inset + +Change to the +\family typewriter +/usr/bin +\family default + directory. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{ +\end_layout + +\end_inset + +Menu +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{} +\end_layout + +\end_inset + + Choice +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +} +\end_layout + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Choice to select from a graphical menu, for instance: +\begin_inset Quotes eld +\end_inset + +Select +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{ +\end_layout + +\end_inset + +Help +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +\backslash +textgreater +\end_layout + +\end_inset + + +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +{} +\end_layout + +\end_inset + + About Mozilla +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +} +\end_layout + +\end_inset + + in your browser. +\begin_inset Quotes erd +\end_inset + + +\end_layout + +\end_inset + + + + +\begin_inset Text + +\begin_layout Standard + +\begin_inset CommandInset href +LatexCommand href +name "The author" +target "http://www.xtrinsic.com" + +\end_inset + + +\end_layout + +\end_inset + + +\begin_inset Text + +\begin_layout Standard +Click-able link to an external web resource. +\end_layout + +\end_inset + + + + +\end_inset + + +\end_layout + +\begin_layout Standard +Thanks to Machtelt +\begin_inset Quotes eld +\end_inset + +Tille +\begin_inset Quotes erd +\end_inset + + Garrels for this list of conventions. +\end_layout + +\begin_layout Section +About My Topic +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "about" + +\end_inset + + +\end_layout + +\begin_layout Standard +Start by explaining the basics of your topic. Is a brief history lesson in order? +\end_layout + +\begin_layout Subsection +Distribution News +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "distro-news" + +\end_inset + + +\end_layout + +\begin_layout Standard +If there is any news specific to each of the distrobutions of Linux, you can include it here. +\end_layout + +\begin_layout Section +Installing from scratch +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "install" + +\end_inset + + +\end_layout + +\begin_layout Standard +Write down each of the steps on how to install any necessary packages/software/etc. Do you need to recompile the kernel to activate new options? +\end_layout + +\begin_layout Standard +If there are any step-by-step instructions, you may want to include them in an example so that they can be easily referred to later. +\end_layout + +\begin_deeper +\begin_layout Standard + +\begin_inset FormulaMacro +\def\labelenumi {\arabic{enumi}.} +\end_inset + + +\end_layout + +\end_deeper +\begin_layout Enumerate +Step One. +\end_layout + +\begin_layout Enumerate +Step Two. +\end_layout + +\begin_layout Enumerate +Step Three. +\end_layout + +\begin_layout Section +Using SOFTWARE +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "using-softwarepackage" + +\end_inset + + +\end_layout + +\begin_layout Standard +Finally! Now you can describe how to use your system/software/package. +\end_layout + +\begin_layout Standard +APPENDIX +\end_layout + +\begin_layout Section +GNU Free Documentation License +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl" + +\end_inset + + +\end_layout + +\begin_layout Section +GNU Free Documentation License +\end_layout + +\begin_layout Standard +Version 1.1, March 2000 +\end_layout + +\begin_layout Quote +Copyright (C) 2000 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. +\end_layout + +\begin_layout Section +PREAMBLE +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-0" + +\end_inset + + +\end_layout + +\begin_layout Standard +The purpose of this License is to make a manual, textbook, or other written document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others. +\end_layout + +\begin_layout Standard +This License is a kind of "copyleft", which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software. +\end_layout + +\begin_layout Standard +We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference. +\end_layout + +\begin_layout Section +APPLICABILITY AND DEFINITIONS +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-1" + +\end_inset + + +\end_layout + +\begin_layout Standard +This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you". +\end_layout + +\begin_layout Standard +A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language. +\end_layout + +\begin_layout Standard +A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them. +\end_layout + +\begin_layout Standard +The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. +\end_layout + +\begin_layout Standard +The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. +\end_layout + +\begin_layout Standard +A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not "Transparent" is called "Opaque". +\end_layout + +\begin_layout Standard +Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout +LaTeX +\end_layout + +\end_inset + + input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML designed for human modification. Opaque formats include PostScript, PDF, proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML produced by some word processors for output purposes only. +\end_layout + +\begin_layout Standard +The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text. +\end_layout + +\begin_layout Section +VERBATIM COPYING +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-2" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3. +\end_layout + +\begin_layout Standard +You may also lend copies, under the same conditions stated above, and you may publicly display copies. +\end_layout + +\begin_layout Section +COPYING IN QUANTITY +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-3" + +\end_inset + + +\end_layout + +\begin_layout Standard +If you publish printed copies of the Document numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects. +\end_layout + +\begin_layout Standard +If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages. +\end_layout + +\begin_layout Standard +If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public. +\end_layout + +\begin_layout Standard +It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document. +\end_layout + +\begin_layout Section +MODIFICATIONS +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-4" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version: +\end_layout + +\begin_deeper +\begin_layout Standard + +\begin_inset FormulaMacro +\def\labelenumi {\Alph{enumi}.} +\end_inset + + +\end_layout + +\end_deeper +\begin_layout Enumerate +Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission. +\end_layout + +\begin_layout Enumerate +List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has less than five). +\end_layout + +\begin_layout Enumerate +State on the Title page the name of the publisher of the Modified Version, as the publisher. +\end_layout + +\begin_layout Enumerate +Preserve all the copyright notices of the Document. +\end_layout + +\begin_layout Enumerate +Add an appropriate copyright notice for your modifications adjacent to the other copyright notices. +\end_layout + +\begin_layout Enumerate +Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below. +\end_layout + +\begin_layout Enumerate +Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice. +\end_layout + +\begin_layout Enumerate +Include an unaltered copy of this License. +\end_layout + +\begin_layout Enumerate +Preserve the section entitled "History", and its title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence. +\end_layout + +\begin_layout Enumerate +Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission. +\end_layout + +\begin_layout Enumerate +In any section entitled "Acknowledgements" or "Dedications", preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein. +\end_layout + +\begin_layout Enumerate +Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles. +\end_layout + +\begin_layout Enumerate +Delete any section entitled "Endorsements". Such a section may not be included in the Modified Version. +\end_layout + +\begin_layout Enumerate +Do not retitle any existing section as "Endorsements" or to conflict in title with any Invariant Section. +\end_layout + +\begin_layout Standard +If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles. +\end_layout + +\begin_layout Standard +You may add a section entitled "Endorsements", provided it contains nothing but endorsements of your Modified Version by various parties- +\begin_inset ERT +status collapsed + +\begin_layout Plain Layout + +\backslash +/ +\end_layout + +\end_inset + +-for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard. +\end_layout + +\begin_layout Standard +You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one. +\end_layout + +\begin_layout Standard +The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version. +\end_layout + +\begin_layout Section +COMBINING DOCUMENTS +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-5" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice. +\end_layout + +\begin_layout Standard +The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work. +\end_layout + +\begin_layout Standard +In the combination, you must combine any sections entitled "History" in the various original documents, forming one section entitled "History"; likewise combine any sections entitled "Acknowledgements", and any sections entitled "Dedications". You must delete all sections entitled "Endorsements." +\end_layout + +\begin_layout Section +COLLECTIONS OF DOCUMENTS +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-6" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects. +\end_layout + +\begin_layout Standard +You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document. +\end_layout + +\begin_layout Section +AGGREGATION WITH INDEPENDENT WORKS +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-7" + +\end_inset + + +\end_layout + +\begin_layout Standard +A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a Modified Version of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an "aggregate", and this License does not apply to the other self-contained works thus compiled with the Document, on account of their being thus compiled, if they are not themselves derivative works of the Document. +\end_layout + +\begin_layout Standard +If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate. +\end_layout + +\begin_layout Section +TRANSLATION +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-8" + +\end_inset + + +\end_layout + +\begin_layout Standard +Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail. +\end_layout + +\begin_layout Section +TERMINATION +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-9" + +\end_inset + + +\end_layout + +\begin_layout Standard +You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. +\end_layout + +\begin_layout Section +FUTURE REVISIONS OF THIS LICENSE +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-10" + +\end_inset + + +\end_layout + +\begin_layout Standard +The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See +\begin_inset Flex Flex:URL +status collapsed + +\begin_layout Plain Layout +http://www.gnu.org/copyleft/ +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Standard +Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation. +\end_layout + +\begin_layout Section +How to use this License for your documents +\end_layout + +\begin_layout Standard + +\begin_inset CommandInset label +LatexCommand label +name "gfdl-11" + +\end_inset + + +\end_layout + +\begin_layout Standard +To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: +\end_layout + +\begin_layout Quote +Copyright (c) YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. A copy of the license is included in the section entitled "GNU Free Documentation License". +\end_layout + +\begin_layout Standard +If you have no Invariant Sections, write "with no Invariant Sections" instead of saying which ones are invariant. If you have no Front-Cover Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being LIST"; likewise for Back-Cover Texts. +\end_layout + +\begin_layout Standard +If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.tex b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.tex new file mode 100644 index 00000000..4740c0ce --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.tex @@ -0,0 +1,473 @@ +\section{About this document}\label{about} + +\subsection{Copyright and License}\label{copyright} + +Copyright (c) YEAR by YOUR NAME. + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.1 or +any later version published by the Free Software Foundation; with no +Invariant Sections, no Front-Cover Texts, and with no Back-Cover Texts. +A copy of the license is included in ?. + +\subsection{Translations}\label{translations} + +If you know of any translations for this document, or you are interested +in translating it, please email me \href{mailto:YOUR EMAIL}{YOUR EMAIL}. + +\subsection{Preface}\label{preface} + +Tell us why you decided to write this document. + +\subsection{Acknowledgments}\label{thanks} + +No one ever writes documentation by themselves. Please take the time to +thank the people who have helped you. + +\subsection{Feedback}\label{feedback} + +Find something wrong with this document? (Or perhaps something right?) I +would love to hear from you. Please email me at +\href{mailto:YOUR EMAIL}{YOUR EMAIL}. + +\subsection{Conventions used in this document}\label{conventions} + +The following typographic and usage conventions occur in this text: + +\begin{longtable}[c]{@{}ll@{}} +\caption{Typographic and usage conventions}\tabularnewline +\toprule +Text type & Meaning\tabularnewline +\midrule +\endfirsthead +\toprule +Text type & Meaning\tabularnewline +\midrule +\endhead +``Quoted text'' & Quotes from people, quoted computer +output.\tabularnewline +\begin{verbatim} +terminal view +\end{verbatim} + & Literal computer input and output captured from the +terminal.\tabularnewline +\texttt{command} & Name of a command that can be entered on the command +line.\tabularnewline +\texttt{option} & Option to a command, as in ``the \texttt{-a} option to +the \texttt{ls} command''.\tabularnewline +\texttt{parameter} & Parameter to a command, as in ``read +\texttt{man\ ls}''.\tabularnewline +\texttt{command\ options\ +arguments} & Command synopsis or general usage, on a separated +line.\tabularnewline +\texttt{filename} & Name of a file or directory, for example ``Change to +the \texttt{/usr/bin} directory.''\tabularnewline +{Menu \textgreater{} Choice} & Choice to select from a graphical menu, +for instance: ``Select {Help \textgreater{} About Mozilla} in your +browser.''\tabularnewline +\href{http://www.xtrinsic.com}{The author} & Click-able link to an +external web resource.\tabularnewline +\bottomrule +\end{longtable} + +Thanks to Machtelt ``Tille'' Garrels for this list of conventions. + +\section{About My Topic}\label{about} + +Start by explaining the basics of your topic. Is a brief history lesson +in order? + +\subsection{Distribution News}\label{distro-news} + +If there is any news specific to each of the distrobutions of Linux, you +can include it here. + +\section{Installing from scratch}\label{install} + +Write down each of the steps on how to install any necessary +packages/software/etc. Do you need to recompile the kernel to activate +new options? + +If there are any step-by-step instructions, you may want to include them +in an example so that they can be easily referred to later. + +\begin{enumerate} +\def\labelenumi{\arabic{enumi}.} +\item + Step One. +\item + Step Two. +\item + Step Three. +\end{enumerate} + +\section{Using SOFTWARE}\label{using-softwarepackage} + +Finally! Now you can describe how to use your system/software/package. + +APPENDIX + +\section{GNU Free Documentation License}\label{gfdl} + +\section{GNU Free Documentation License} + +Version 1.1, March 2000 + +\begin{quote} +Copyright (C) 2000 Free Software Foundation, Inc. 59 Temple Place, Suite +330, Boston, MA 02111-1307 USA Everyone is permitted to copy and +distribute verbatim copies of this license document, but changing it is +not allowed. +\end{quote} + +\section{PREAMBLE}\label{gfdl-0} + +The purpose of this License is to make a manual, textbook, or other +written document "free" in the sense of freedom: to assure everyone the +effective freedom to copy and redistribute it, with or without modifying +it, either commercially or noncommercially. Secondarily, this License +preserves for the author and publisher a way to get credit for their +work, while not being considered responsible for modifications made by +others. + +This License is a kind of "copyleft", which means that derivative works +of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft license +designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free program +should come with manuals providing the same freedoms that the software +does. But this License is not limited to software manuals; it can be +used for any textual work, regardless of subject matter or whether it is +published as a printed book. We recommend this License principally for +works whose purpose is instruction or reference. + +\section{APPLICABILITY AND DEFINITIONS}\label{gfdl-1} + +This License applies to any manual or other work that contains a notice +placed by the copyright holder saying it can be distributed under the +terms of this License. The "Document", below, refers to any such manual +or work. Any member of the public is a licensee, and is addressed as +"you". + +A "Modified Version" of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall subject +(or to related matters) and contains nothing that could fall directly +within that overall subject. (For example, if the Document is in part a +textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding them. + +The "Invariant Sections" are certain Secondary Sections whose titles are +designated, as being those of Invariant Sections, in the notice that +says that the Document is released under this License. + +The "Cover Texts" are certain short passages of text that are listed, as +Front-Cover Texts or Back-Cover Texts, in the notice that says that the +Document is released under this License. + +A "Transparent" copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the general +public, whose contents can be viewed and edited directly and +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or for +automatic translation to a variety of formats suitable for input to text +formatters. A copy made in an otherwise Transparent file format whose +markup has been designed to thwart or discourage subsequent modification +by readers is not Transparent. A copy that is not "Transparent" is +called "Opaque". + +Examples of suitable formats for Transparent copies include plain ASCII +without markup, Texinfo input format, LaTeX input format, SGML or XML +using a publicly available DTD, and standard-conforming simple HTML +designed for human modification. Opaque formats include PostScript, PDF, +proprietary formats that can be read and edited only by proprietary word +processors, SGML or XML for which the DTD and/or processing tools are +not generally available, and the machine-generated HTML produced by some +word processors for output purposes only. + +The "Title Page" means, for a printed book, the title page itself, plus +such following pages as are needed to hold, legibly, the material this +License requires to appear in the title page. For works in formats which +do not have any title page as such, "Title Page" means the text near the +most prominent appearance of the work's title, preceding the beginning +of the body of the text. + +\section{VERBATIM COPYING}\label{gfdl-2} + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies to +the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further copying +of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + +\section{COPYING IN QUANTITY}\label{gfdl-3} + +If you publish printed copies of the Document numbering more than 100, +and the Document's license notice requires Cover Texts, you must enclose +the copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the +back cover. Both covers must also clearly and legibly identify you as +the publisher of these copies. The front cover must present the full +title with all words of the title equally prominent and visible. You may +add other material on the covers in addition. Copying with changes +limited to the covers, as long as they preserve the title of the +Document and satisfy these conditions, can be treated as verbatim +copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy a +publicly-accessible computer-network location containing a complete +Transparent copy of the Document, free of added material, which the +general network-using public has access to download anonymously at no +charge using public-standard network protocols. If you use the latter +option, you must take reasonably prudent steps, when you begin +distribution of Opaque copies in quantity, to ensure that this +Transparent copy will remain thus accessible at the stated location +until at least one year after the last time you distribute an Opaque +copy (directly or through your agents or retailers) of that edition to +the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to give +them a chance to provide you with an updated version of the Document. + +\section{MODIFICATIONS}\label{gfdl-4} + +You may copy and distribute a Modified Version of the Document under the +conditions of sections 2 and 3 above, provided that you release the +Modified Version under precisely this License, with the Modified Version +filling the role of the Document, thus licensing distribution and +modification of the Modified Version to whoever possesses a copy of it. +In addition, you must do these things in the Modified Version: + +\begin{enumerate} +\def\labelenumi{\Alph{enumi}.} +\item + Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions (which + should, if there were any, be listed in the History section of the + Document). You may use the same title as a previous version if the + original publisher of that version gives permission. +\item + List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has less than five). +\item + State on the Title page the name of the publisher of the Modified + Version, as the publisher. +\item + Preserve all the copyright notices of the Document. +\item + Add an appropriate copyright notice for your modifications adjacent to + the other copyright notices. +\item + Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below. +\item + Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. +\item + Include an unaltered copy of this License. +\item + Preserve the section entitled "History", and its title, and add to it + an item stating at least the title, year, new authors, and publisher + of the Modified Version as given on the Title Page. If there is no + section entitled "History" in the Document, create one stating the + title, year, authors, and publisher of the Document as given on its + Title Page, then add an item describing the Modified Version as stated + in the previous sentence. +\item + Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise the + network locations given in the Document for previous versions it was + based on. These may be placed in the "History" section. You may omit a + network location for a work that was published at least four years + before the Document itself, or if the original publisher of the + version it refers to gives permission. +\item + In any section entitled "Acknowledgements" or "Dedications", preserve + the section's title, and preserve in the section all the substance and + tone of each of the contributor acknowledgements and/or dedications + given therein. +\item + Preserve all the Invariant Sections of the Document, unaltered in + their text and in their titles. Section numbers or the equivalent are + not considered part of the section titles. +\item + Delete any section entitled "Endorsements". Such a section may not be + included in the Modified Version. +\item + Do not retitle any existing section as "Endorsements" or to conflict + in title with any Invariant Section. +\end{enumerate} + +If the Modified Version includes new front-matter sections or appendices +that qualify as Secondary Sections and contain no material copied from +the Document, you may at your option designate some or all of these +sections as invariant. To do this, add their titles to the list of +Invariant Sections in the Modified Version's license notice. These +titles must be distinct from any other section titles. + +You may add a section entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties-\/-for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of Front-Cover +Text and one of Back-Cover Text may be added by (or through arrangements +made by) any one entity. If the Document already includes a cover text +for the same cover, previously added by you or by arrangement made by +the same entity you are acting on behalf of, you may not add another; +but you may replace the old one, on explicit permission from the +previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + +\section{COMBINING DOCUMENTS}\label{gfdl-5} + +You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its license +notice. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by adding +at the end of it, in parentheses, the name of the original author or +publisher of that section if known, or else a unique number. Make the +same adjustment to the section titles in the list of Invariant Sections +in the license notice of the combined work. + +In the combination, you must combine any sections entitled "History" in +the various original documents, forming one section entitled "History"; +likewise combine any sections entitled "Acknowledgements", and any +sections entitled "Dedications". You must delete all sections entitled +"Endorsements." + +\section{COLLECTIONS OF DOCUMENTS}\label{gfdl-6} + +You may make a collection consisting of the Document and other documents +released under this License, and replace the individual copies of this +License in the various documents with a single copy that is included in +the collection, provided that you follow the rules of this License for +verbatim copying of each of the documents in all other respects. + +You may extract a single document from such a collection, and distribute +it individually under this License, provided you insert a copy of this +License into the extracted document, and follow this License in all +other respects regarding verbatim copying of that document. + +\section{AGGREGATION WITH INDEPENDENT WORKS}\label{gfdl-7} + +A compilation of the Document or its derivatives with other separate and +independent documents or works, in or on a volume of a storage or +distribution medium, does not as a whole count as a Modified Version of +the Document, provided no compilation copyright is claimed for the +compilation. Such a compilation is called an "aggregate", and this +License does not apply to the other self-contained works thus compiled +with the Document, on account of their being thus compiled, if they are +not themselves derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these copies +of the Document, then if the Document is less than one quarter of the +entire aggregate, the Document's Cover Texts may be placed on covers +that surround only the Document within the aggregate. Otherwise they +must appear on covers around the whole aggregate. + +\section{TRANSLATION}\label{gfdl-8} + +Translation is considered a kind of modification, so you may distribute +translations of the Document under the terms of section 4. Replacing +Invariant Sections with translations requires special permission from +their copyright holders, but you may include translations of some or all +Invariant Sections in addition to the original versions of these +Invariant Sections. You may include a translation of this License +provided that you also include the original English version of this +License. In case of a disagreement between the translation and the +original English version of this License, the original English version +will prevail. + +\section{TERMINATION}\label{gfdl-9} + +You may not copy, modify, sublicense, or distribute the Document except +as expressly provided for under this License. Any other attempt to copy, +modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, parties +who have received copies, or rights, from you under this License will +not have their licenses terminated so long as such parties remain in +full compliance. + +\section{FUTURE REVISIONS OF THIS LICENSE}\label{gfdl-10} + +The Free Software Foundation may publish new, revised versions of the +GNU Free Documentation License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. See +\url{http://www.gnu.org/copyleft/}. + +Each version of the License is given a distinguishing version number. If +the Document specifies that a particular numbered version of this +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + +\section{How to use this License for your documents}\label{gfdl-11} + +To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and license +notices just after the title page: + +\begin{quote} +Copyright (c) YEAR YOUR NAME. Permission is granted to copy, distribute +and/or modify this document under the terms of the GNU Free +Documentation License, Version 1.1 or any later version published by the +Free Software Foundation; with the Invariant Sections being LIST THEIR +TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover +Texts being LIST. A copy of the license is included in the section +entitled "GNU Free Documentation License". +\end{quote} + +If you have no Invariant Sections, write "with no Invariant Sections" +instead of saying which ones are invariant. If you have no Front-Cover +Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being +LIST"; likewise for Back-Cover Texts. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of free +software license, such as the GNU General Public License, to permit +their use in free software. diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.txt b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.txt new file mode 100644 index 00000000..e03e9e5d --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.txt @@ -0,0 +1,591 @@ +\begin{verbatim} + + + + + + + + + + + +\end{verbatim} + +{]}\textgreater{} + +Sample XML HOWTO + + Your Given Name Your Family Name (Surname) + +A short sentence about who you are. + + company name + +\begin{verbatim} + +
+ youremail@domain.NOSPAM.org +
+ +\end{verbatim} + +YYYY-MM-DD + +This is a sample DocBook XML HOWTO which you may use as a document +template. + + 1.1 2005-03-04 ME A short note about what you have changed. 1.0 +YYYY-MM-DD ME First official release. + +About this document + +Copyright and License + +\begin{verbatim} + Copyright (c) YEAR by YOUR NAME. + Permission is granted to copy, distribute and/or modify this + document under the terms of the GNU Free Documentation License, Version + 1.1 or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and with no Back-Cover + Texts. + A copy of the license is included in . + +\end{verbatim} + +Translations + +If you know of any translations for this document, or you are interested +in translating it, please email me YOUR EMAIL. + +Preface + +\begin{verbatim} +Tell us why you decided to write this document. +\end{verbatim} + +Acknowledgments + +No one ever writes documentation by themselves. Please take the time to +thank the people who have helped you. + +Feedback + +\begin{verbatim} +Find something wrong with this document? (Or perhaps something right?) I would love to hear from you. Please email me at YOUR EMAIL. +\end{verbatim} + +Conventions used in this document + +The following typographic and usage conventions occur in this text: + +Typographic and usage conventions + +Text typeMeaning + + Quoted text Quotes from people, quoted computer output. + +terminal view + + Literal computer input and output captured from the terminal. command +Name of a command that can be entered on the command line. option Option +to a command, as in the -a option to the ls command. parameter Parameter +to a command, as in read man ls. + +command options arguments + + Command synopsis or general usage, on a separated line. filename Name +of a file or directory, for example Change to the /usr/bin directory. +MenuChoice Choice to select from a graphical menu, for instance: Select +HelpAbout Mozilla in your browser. The author Click-able link to an +external web resource. + +Thanks to Machtelt Tille Garrels for this list of conventions. + +About My Topic + +Start by explaining the basics of your topic. Is a brief history lesson +in order? + +Distribution News + +If there is any news specific to each of the distrobutions of Linux, you +can include it here. + +Installing from scratch + +Write down each of the steps on how to install any necessary +packages/software/etc. Do you need to recompile the kernel to activate +new options? + +If there are any step-by-step instructions, you may want to include them +in an example so that they can be easily referred to later. + +Installation Instructions + +\begin{verbatim} +Step One. +Step Two. +Step Three. +\end{verbatim} + +Using SOFTWARE + +Finally! Now you can describe how to use your system/software/package. + +\&appendix; + +GNU Free Documentation License + +GNU Free Documentation License + +\begin{verbatim} +Version 1.1, March 2000 + +
+ Copyright (C) 2000 Free Software Foundation, Inc. +\end{verbatim} + +59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is +permitted to copy and distribute verbatim copies of this license +document, but changing it is not allowed. + +\begin{verbatim} +
+ +\end{verbatim} + +PREAMBLE + +\begin{verbatim} +The purpose of this License is to make a manual, textbook, +or other written document "free" in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or +noncommercially. Secondarily, this License preserves for the +author and publisher a way to get credit for their work, while not +being considered responsible for modifications made by +others. + +This License is a kind of "copyleft", which means that +derivative works of the document must themselves be free in the +same sense. It complements the GNU General Public License, which +is a copyleft license designed for free software. + +We have designed this License in order to use it for manuals +for free software, because free software needs free documentation: +a free program should come with manuals providing the same +freedoms that the software does. But this License is not limited +to software manuals; it can be used for any textual work, +regardless of subject matter or whether it is published as a +printed book. We recommend this License principally for works +whose purpose is instruction or reference. +\end{verbatim} + +APPLICABILITY AND DEFINITIONS + +\begin{verbatim} +This License applies to any manual or other work that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. The "Document", +below, refers to any such manual or work. Any member of the +public is a licensee, and is addressed as "you". + +A "Modified Version" of the Document means any work +containing the Document or a portion of it, either copied +verbatim, or with modifications and/or translated into another +language. + +A "Secondary Section" is a named appendix or a front-matter +section of the Document that deals exclusively with the +relationship of the publishers or authors of the Document to the +Document's overall subject (or to related matters) and contains +nothing that could fall directly within that overall subject. +(For example, if the Document is in part a textbook of +mathematics, a Secondary Section may not explain any mathematics.) +The relationship could be a matter of historical connection with +the subject or with related matters, or of legal, commercial, +philosophical, ethical or political position regarding +them. + +The "Invariant Sections" are certain Secondary Sections +whose titles are designated, as being those of Invariant Sections, +in the notice that says that the Document is released under this +License. + +The "Cover Texts" are certain short passages of text that +are listed, as Front-Cover Texts or Back-Cover Texts, in the +notice that says that the Document is released under this +License. + +A "Transparent" copy of the Document means a +machine-readable copy, represented in a format whose specification +is available to the general public, whose contents can be viewed +and edited directly and straightforwardly with generic text +editors or (for images composed of pixels) generic paint programs +or (for drawings) some widely available drawing editor, and that +is suitable for input to text formatters or for automatic +translation to a variety of formats suitable for input to text +formatters. A copy made in an otherwise Transparent file format +whose markup has been designed to thwart or discourage subsequent +modification by readers is not Transparent. A copy that is not +"Transparent" is called "Opaque". + +Examples of suitable formats for Transparent copies include +plain ASCII without markup, Texinfo input format, LaTeX input +format, SGML or XML using a publicly available DTD, and +standard-conforming simple HTML designed for human modification. +Opaque formats include PostScript, PDF, proprietary formats that +can be read and edited only by proprietary word processors, SGML +or XML for which the DTD and/or processing tools are not generally +available, and the machine-generated HTML produced by some word +processors for output purposes only. + +The "Title Page" means, for a printed book, the title page +itself, plus such following pages as are needed to hold, legibly, +the material this License requires to appear in the title page. +For works in formats which do not have any title page as such, +"Title Page" means the text near the most prominent appearance of +the work's title, preceding the beginning of the body of the +text. +\end{verbatim} + +VERBATIM COPYING + +\begin{verbatim} +You may copy and distribute the Document in any medium, +either commercially or noncommercially, provided that this +License, the copyright notices, and the license notice saying this +License applies to the Document are reproduced in all copies, and +that you add no other conditions whatsoever to those of this +License. You may not use technical measures to obstruct or +control the reading or further copying of the copies you make or +distribute. However, you may accept compensation in exchange for +copies. If you distribute a large enough number of copies you +must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated +above, and you may publicly display copies. +\end{verbatim} + +COPYING IN QUANTITY + +\begin{verbatim} +If you publish printed copies of the Document numbering more +than 100, and the Document's license notice requires Cover Texts, +you must enclose the copies in covers that carry, clearly and +legibly, all these Cover Texts: Front-Cover Texts on the front +cover, and Back-Cover Texts on the back cover. Both covers must +also clearly and legibly identify you as the publisher of these +copies. The front cover must present the full title with all +words of the title equally prominent and visible. You may add +other material on the covers in addition. Copying with changes +limited to the covers, as long as they preserve the title of the +Document and satisfy these conditions, can be treated as verbatim +copying in other respects. + +If the required texts for either cover are too voluminous to +fit legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto +adjacent pages. + +If you publish or distribute Opaque copies of the Document +numbering more than 100, you must either include a +machine-readable Transparent copy along with each Opaque copy, or +state in or with each Opaque copy a publicly-accessible +computer-network location containing a complete Transparent copy +of the Document, free of added material, which the general +network-using public has access to download anonymously at no +charge using public-standard network protocols. If you use the +latter option, you must take reasonably prudent steps, when you +begin distribution of Opaque copies in quantity, to ensure that +this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you +distribute an Opaque copy (directly or through your agents or +retailers) of that edition to the public. + +It is requested, but not required, that you contact the +authors of the Document well before redistributing any large +number of copies, to give them a chance to provide you with an +updated version of the Document. +\end{verbatim} + +MODIFICATIONS + +\begin{verbatim} +You may copy and distribute a Modified Version of the +Document under the conditions of sections 2 and 3 above, provided +that you release the Modified Version under precisely this +License, with the Modified Version filling the role of the +Document, thus licensing distribution and modification of the +Modified Version to whoever possesses a copy of it. In addition, +you must do these things in the Modified Version: + + + Use in the Title Page + (and on the covers, if any) a title distinct from that of the + Document, and from those of previous versions (which should, if + there were any, be listed in the History section of the + Document). You may use the same title as a previous version if + the original publisher of that version gives permission. + + + List on the Title Page, + as authors, one or more persons or entities responsible for + authorship of the modifications in the Modified Version, + together with at least five of the principal authors of the + Document (all of its principal authors, if it has less than + five). + + + State on the Title page + the name of the publisher of the Modified Version, as the + publisher. + + + Preserve all the + copyright notices of the Document. + + + Add an appropriate + copyright notice for your modifications adjacent to the other + copyright notices. + + + Include, immediately + after the copyright notices, a license notice giving the public + permission to use the Modified Version under the terms of this + License, in the form shown in the Addendum below. + + + Preserve in that license + notice the full lists of Invariant Sections and required Cover + Texts given in the Document's license notice. + + + Include an unaltered + copy of this License. + + + Preserve the section + entitled "History", and its title, and add to it an item stating + at least the title, year, new authors, and publisher of the + Modified Version as given on the Title Page. If there is no + section entitled "History" in the Document, create one stating + the title, year, authors, and publisher of the Document as given + on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. + + + Preserve the network + location, if any, given in the Document for public access to a + Transparent copy of the Document, and likewise the network + locations given in the Document for previous versions it was + based on. These may be placed in the "History" section. You + may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. + + + In any section entitled + "Acknowledgements" or "Dedications", preserve the section's + title, and preserve in the section all the substance and tone of + each of the contributor acknowledgements and/or dedications + given therein. + + + Preserve all the + Invariant Sections of the Document, unaltered in their text and + in their titles. Section numbers or the equivalent are not + considered part of the section titles. + + + Delete any section + entitled "Endorsements". Such a section may not be included in + the Modified Version. + + + Do not retitle any + existing section as "Endorsements" or to conflict in title with + any Invariant Section. + + + +If the Modified Version includes new front-matter sections +or appendices that qualify as Secondary Sections and contain no +material copied from the Document, you may at your option +designate some or all of these sections as invariant. To do this, +add their titles to the list of Invariant Sections in the Modified +Version's license notice. These titles must be distinct from any +other section titles. + +You may add a section entitled "Endorsements", provided it +contains nothing but endorsements of your Modified Version by +various parties--for example, statements of peer review or that +the text has been approved by an organization as the authoritative +definition of a standard. + +You may add a passage of up to five words as a Front-Cover +Text, and a passage of up to 25 words as a Back-Cover Text, to the +end of the list of Cover Texts in the Modified Version. Only one +passage of Front-Cover Text and one of Back-Cover Text may be +added by (or through arrangements made by) any one entity. If the +Document already includes a cover text for the same cover, +previously added by you or by arrangement made by the same entity +you are acting on behalf of, you may not add another; but you may +replace the old one, on explicit permission from the previous +publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by +this License give permission to use their names for publicity for +or to assert or imply endorsement of any Modified Version. +\end{verbatim} + +COMBINING DOCUMENTS + +\begin{verbatim} +You may combine the Document with other documents released +under this License, under the terms defined in section 4 above for +modified versions, provided that you include in the combination +all of the Invariant Sections of all of the original documents, +unmodified, and list them all as Invariant Sections of your +combined work in its license notice. + +The combined work need only contain one copy of this +License, and multiple identical Invariant Sections may be replaced +with a single copy. If there are multiple Invariant Sections with +the same name but different contents, make the title of each such +section unique by adding at the end of it, in parentheses, the +name of the original author or publisher of that section if known, +or else a unique number. Make the same adjustment to the section +titles in the list of Invariant Sections in the license notice of +the combined work. + +In the combination, you must combine any sections entitled +"History" in the various original documents, forming one section +entitled "History"; likewise combine any sections entitled +"Acknowledgements", and any sections entitled "Dedications". You +must delete all sections entitled "Endorsements." +\end{verbatim} + +COLLECTIONS OF DOCUMENTS + +\begin{verbatim} +You may make a collection consisting of the Document and +other documents released under this License, and replace the +individual copies of this License in the various documents with a +single copy that is included in the collection, provided that you +follow the rules of this License for verbatim copying of each of +the documents in all other respects. + +You may extract a single document from such a collection, +and distribute it individually under this License, provided you +insert a copy of this License into the extracted document, and +follow this License in all other respects regarding verbatim +copying of that document. +\end{verbatim} + +AGGREGATION WITH INDEPENDENT WORKS + +\begin{verbatim} +A compilation of the Document or its derivatives with other +separate and independent documents or works, in or on a volume of +a storage or distribution medium, does not as a whole count as a +Modified Version of the Document, provided no compilation +copyright is claimed for the compilation. Such a compilation is +called an "aggregate", and this License does not apply to the +other self-contained works thus compiled with the Document, on +account of their being thus compiled, if they are not themselves +derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to +these copies of the Document, then if the Document is less than +one quarter of the entire aggregate, the Document's Cover Texts +may be placed on covers that surround only the Document within the +aggregate. Otherwise they must appear on covers around the whole +aggregate. +\end{verbatim} + +TRANSLATION + +\begin{verbatim} +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section +4. Replacing Invariant Sections with translations requires +special permission from their copyright holders, but you may +include translations of some or all Invariant Sections in addition +to the original versions of these Invariant Sections. You may +include a translation of this License provided that you also +include the original English version of this License. In case of +a disagreement between the translation and the original English +version of this License, the original English version will +prevail. +\end{verbatim} + +TERMINATION + +\begin{verbatim} +You may not copy, modify, sublicense, or distribute the +Document except as expressly provided for under this License. Any +other attempt to copy, modify, sublicense or distribute the +Document is void, and will automatically terminate your rights +under this License. However, parties who have received copies, or +rights, from you under this License will not have their licenses +terminated so long as such parties remain in full +compliance. +\end{verbatim} + +FUTURE REVISIONS OF THIS LICENSE + +\begin{verbatim} +The Free Software Foundation may publish new, revised +versions of the GNU Free Documentation License from time to time. +Such new versions will be similar in spirit to the present +version, but may differ in detail to address new problems or +concerns. See http://www.gnu.org/copyleft/. + +Each version of the License is given a distinguishing +version number. If the Document specifies that a particular +numbered version of this License "or any later version" applies to +it, you have the option of following the terms and conditions +either of that specified version or of any later version that has +been published (not as a draft) by the Free Software Foundation. +If the Document does not specify a version number of this License, +you may choose any version ever published (not as a draft) by the +Free Software Foundation. +\end{verbatim} + +How to use this License for your documents + +\begin{verbatim} +To use this License in a document you have written, include +a copy of the License in the document and put the following +copyright and license notices just after the title page: +\end{verbatim} + +\begin{verbatim} + Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.1 + or any later version published by the Free Software Foundation; + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + A copy of the license is included in the section entitled "GNU + Free Documentation License". +\end{verbatim} + +\begin{verbatim} +If you have no Invariant Sections, write "with no Invariant +Sections" instead of saying which ones are invariant. If you have +no Front-Cover Texts, write "no Front-Cover Texts" instead of +"Front-Cover Texts being LIST"; likewise for Back-Cover +Texts. + +If your document contains nontrivial examples of program +code, we recommend releasing these examples in parallel under your +choice of free software license, such as the GNU General Public +License, to permit their use in free software. +\end{verbatim} + + From 21cf7a8c5567981091831f4a597e3f2c5d6373a8 Mon Sep 17 00:00:00 2001 From: tgeek77 Date: Sun, 17 Jan 2016 19:16:17 +0100 Subject: [PATCH 04/10] Added .gitignore --- .gitignore | 1 + 1 file changed, 1 insertion(+) create mode 100644 .gitignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..b25c15b8 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +*~ From 0192db68f16c39af97e9d688d3a4e38f3e3417cc Mon Sep 17 00:00:00 2001 From: tgeek77 Date: Sun, 17 Jan 2016 19:19:03 +0100 Subject: [PATCH 05/10] Deleting extra files --- .../Templates/Guide/ldp-bibliography.xml.lyx~ | 224 --- .../Templates/Guide/ldp-guide-chap2.xml.lyx~ | 478 ------ .../Templates/Howto/ldp-howto.lyx~ | 1472 ----------------- 3 files changed, 2174 deletions(-) delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ deleted file mode 100644 index 6a846ed6..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.lyx~ +++ /dev/null @@ -1,224 +0,0 @@ -#LyX file created by tex2lyx 2.1 -\lyxformat 474 -\begin_document -\begin_header -\textclass article -\use_default_options false -\maintain_unincluded_children false -\language english -\language_package none -\inputencoding auto -\fontencoding default -\font_roman default -\font_sans default -\font_typewriter default -\font_math auto -\font_default_family default -\use_non_tex_fonts false -\font_sc false -\font_osf false -\font_sf_scale 100 -\font_tt_scale 100 -\graphics default -\default_output_format default -\output_sync 0 -\bibtex_command default -\index_command default -\paperfontsize default -\spacing single -\use_hyperref false -\papersize default -\use_geometry false -\use_package amsmath 1 -\use_package amssymb 0 -\use_package cancel 0 -\use_package esint 1 -\use_package mathdots 0 -\use_package mathtools 0 -\use_package mhchem 0 -\use_package stackrel 0 -\use_package stmaryrd 0 -\use_package undertilde 0 -\cite_engine basic -\cite_engine_type default -\biblio_style plain -\use_bibtopic false -\use_indices false -\paperorientation portrait -\suppress_date false -\justification true -\use_refstyle 0 -\index Index -\shortcut idx -\color #008000 -\end_index -\secnumdepth 3 -\tocdepth 3 -\paragraph_separation indent -\paragraph_indentation default -\quotes_language english -\papercolumns 1 -\papersides 1 -\paperpagestyle default -\tracking_changes false -\output_changes false -\html_math_output 0 -\html_css_as_file 0 -\html_be_strict false -\end_header - -\begin_body - -\begin_layout Section -References and Resources -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "bibliography" - -\end_inset - - -\end_layout - -\begin_layout Section -HOWTOs -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "ref-howto" - -\end_inset - - -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset href -LatexCommand href -name "" -target "URL" - -\end_inset - - -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset href -LatexCommand href -name "" -target "URL 2" - -\end_inset - - -\end_layout - -\begin_layout Section -Hardware-specific Install Reports and Info -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "ref-installreports" - -\end_inset - - -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset href -LatexCommand href -name "" -target "URL 3" - -\end_inset - - -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset href -LatexCommand href -name "" -target "URL 4" - -\end_inset - - -\end_layout - -\begin_layout Section -Mailing List Threads -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "ref-mailinglist" - -\end_inset - - -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset href -LatexCommand href -name "" -target "URL 5" - -\end_inset - - -\end_layout - -\begin_layout Section -Packages and related software -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "ref-software" - -\end_inset - - -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset href -LatexCommand href -name "" -target "http://www.kernel.org" - -\end_inset - - -\end_layout - -\begin_layout Quote -Remember to choose "F" for full when you download your kernel source. -\end_layout - -\end_body -\end_document diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ deleted file mode 100644 index 75444f98..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx~ +++ /dev/null @@ -1,478 +0,0 @@ -#LyX file created by tex2lyx 2.1 -\lyxformat 474 -\begin_document -\begin_header -\textclass article -\use_default_options false -\maintain_unincluded_children false -\language english -\language_package none -\inputencoding auto -\fontencoding default -\font_roman default -\font_sans default -\font_typewriter default -\font_math auto -\font_default_family default -\use_non_tex_fonts false -\font_sc false -\font_osf false -\font_sf_scale 100 -\font_tt_scale 100 -\graphics default -\default_output_format default -\output_sync 0 -\bibtex_command default -\index_command default -\paperfontsize default -\spacing single -\use_hyperref false -\papersize default -\use_geometry false -\use_package amsmath 1 -\use_package amssymb 0 -\use_package cancel 0 -\use_package esint 1 -\use_package mathdots 0 -\use_package mathtools 0 -\use_package mhchem 0 -\use_package stackrel 0 -\use_package stmaryrd 0 -\use_package undertilde 0 -\cite_engine basic -\cite_engine_type default -\biblio_style plain -\use_bibtopic false -\use_indices false -\paperorientation portrait -\suppress_date false -\justification true -\use_refstyle 0 -\index Index -\shortcut idx -\color #008000 -\end_index -\secnumdepth 3 -\tocdepth 3 -\paragraph_separation indent -\paragraph_indentation default -\quotes_language english -\papercolumns 1 -\papersides 1 -\paperpagestyle default -\tracking_changes false -\output_changes false -\html_math_output 0 -\html_css_as_file 0 -\html_be_strict false -\end_header - -\begin_body - -\begin_layout Section -Title of second chapter -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "chapux5f02" - -\end_inset - - -\end_layout - -\begin_layout Quote -What we will do in this chapter: -\end_layout - -\begin_deeper -\begin_layout Itemize -stuff -\end_layout - -\begin_layout Itemize -more stuff -\end_layout - -\begin_layout Itemize -talk about other stuff -\end_layout - -\begin_layout Itemize -play with stuff -\end_layout - -\end_deeper -\begin_layout Section -Section1 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f01" - -\end_inset - - -\end_layout - -\begin_layout Subsection -Section2 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f01ux5f01" - -\end_inset - - -\end_layout - -\begin_layout Subsubsection -Section3 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f01ux5f01ux5f01" - -\end_inset - - -\end_layout - -\begin_layout Standard -Intro -\end_layout - -\begin_deeper -\begin_layout Standard - -\begin_inset FormulaMacro -\def\labelenumi {\arabic{enumi}.} -\end_inset - - -\end_layout - -\end_deeper -\begin_layout Enumerate -Summing up a few things -\end_layout - -\begin_layout Enumerate -in a list -\end_layout - -\begin_layout Enumerate -where items are numbered -\end_layout - -\begin_layout Standard -Explanations -\end_layout - -\begin_layout Subsubsection -Section3 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f01ux5f01ux5f01" - -\end_inset - - -\end_layout - -\begin_layout Standard -Other explanation -\end_layout - -\begin_layout Itemize -Summing up a few things -\end_layout - -\begin_layout Itemize -in a list -\end_layout - -\begin_layout Itemize -where items are not numbered -\end_layout - -\begin_layout Standard -And discussion -\end_layout - -\begin_layout Subsection -Section2 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f01ux5f02" - -\end_inset - - -\end_layout - -\begin_layout Standard -Showing a picture in text: -\end_layout - -\begin_layout Standard - -\begin_inset Graphics - filename your_images_dir/image.eps - -\end_inset - - -\end_layout - -\begin_layout Standard -PNG is for on-line browsing, EPS for printing. -\family typewriter -gimp -\family default - and/or -\family typewriter -convert -\family default - will do the trick, starting from about any source format. -\end_layout - -\begin_layout Section -Section1 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f02" - -\end_inset - - -\end_layout - -\begin_layout Subsection -Section2 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f02ux5f01" - -\end_inset - - -\end_layout - -\begin_layout Standard -This is a table with two colums: -\end_layout - -\begin_layout Standard - -\begin_inset Tabular - - - - - - -\begin_inset Text - -\begin_layout Standard - -\begin_inset Caption Standard - -\begin_layout Plain Layout -Table title -\end_layout - -\end_inset - - -\end_layout - -\end_inset - - -\begin_inset Text - -\end_inset - - - - -\begin_inset Text - -\begin_layout Standard -first colum header -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Standard -second colum header -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Standard -first colum header -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Standard -second colum header -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Standard -item -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Standard -meaning -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Standard -item -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Standard -meaning -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Standard -item -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Standard -meaning -\end_layout - -\end_inset - - - - -\end_inset - - -\end_layout - -\begin_layout Subsection -Section2 title -\end_layout - -\begin_layout Standard - -\begin_inset CommandInset label -LatexCommand label -name "sectux5f02ux5f02ux5f02" - -\end_inset - - -\end_layout - -\begin_layout Standard -This is a link to the first section of the first chapter: ?. -\end_layout - -\begin_layout Standard -This is an external link: -\begin_inset CommandInset href -LatexCommand href -name "" -target "http://www.somewhere.org" - -\end_inset - -. -\end_layout - -\begin_layout Standard -This is also -\begin_inset CommandInset href -LatexCommand href -name "an external link" -target "http://www.somewhere.org" - -\end_inset - -, only here you don't see the URL. -\end_layout - -\end_body -\end_document diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ deleted file mode 100644 index 1ec464f8..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.lyx~ +++ /dev/null @@ -1,1472 +0,0 @@ -#LyX 2.1 created this file. For more info see http://www.lyx.org/ -\lyxformat 474 -\begin_document -\begin_header -\textclass article -\use_default_options false -\maintain_unincluded_children false -\language english -\language_package none -\inputencoding auto -\fontencoding default -\font_roman default -\font_sans default -\font_typewriter default -\font_math auto -\font_default_family default -\use_non_tex_fonts false -\font_sc false -\font_osf false -\font_sf_scale 100 -\font_tt_scale 100 -\graphics default -\default_output_format default -\output_sync 0 -\bibtex_command default -\index_command default -\paperfontsize default -\spacing single -\use_hyperref false -\papersize default -\use_geometry false -\use_package amsmath 1 -\use_package amssymb 0 -\use_package cancel 0 -\use_package esint 1 -\use_package mathdots 0 -\use_package mathtools 0 -\use_package mhchem 0 -\use_package stackrel 0 -\use_package stmaryrd 0 -\use_package undertilde 0 -\cite_engine basic -\cite_engine_type default -\biblio_style plain -\use_bibtopic false -\use_indices false -\paperorientation portrait -\suppress_date false -\justification true -\use_refstyle 0 -\index Index -\shortcut idx -\color #008000 -\end_index -\secnumdepth 3 -\tocdepth 3 -\paragraph_separation indent -\paragraph_indentation default -\quotes_language english -\papercolumns 1 -\papersides 1 -\paperpagestyle default -\tracking_changes false -\output_changes false -\html_math_output 0 -\html_css_as_file 0 -\html_be_strict false -\end_header - -\begin_body - -\begin_layout Section -About this document -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "about" - -\end_inset - - -\end_layout - -\begin_layout Subsection -Copyright and License -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "copyright" - -\end_inset - - -\end_layout - -\begin_layout Standard -Copyright (c) YEAR by YOUR NAME. -\end_layout - -\begin_layout Standard -Permission is granted to copy, distribute and/or modify this document under - the terms of the GNU Free Documentation License, Version 1.1 or any later - version published by the Free Software Foundation; with no Invariant Sections, - no Front-Cover Texts, and with no Back-Cover Texts. - A copy of the license is included in ?. -\end_layout - -\begin_layout Subsection -Translations -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "translations" - -\end_inset - - -\end_layout - -\begin_layout Standard -If you know of any translations for this document, or you are interested - in translating it, please email me -\begin_inset CommandInset href -LatexCommand href -target "YOUR EMAIL" -type "mailto:" - -\end_inset - -. -\end_layout - -\begin_layout Subsection -Preface -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "preface" - -\end_inset - - -\end_layout - -\begin_layout Standard -Tell us why you decided to write this document. -\end_layout - -\begin_layout Subsection -Acknowledgments -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "thanks" - -\end_inset - - -\end_layout - -\begin_layout Standard -No one ever writes documentation by themselves. - Please take the time to thank the people who have helped you. -\end_layout - -\begin_layout Subsection -Feedback -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "feedback" - -\end_inset - - -\end_layout - -\begin_layout Standard -Find something wrong with this document? (Or perhaps something right?) I - would love to hear from you. - Please email me at -\begin_inset CommandInset href -LatexCommand href -target "YOUR EMAIL" -type "mailto:" - -\end_inset - -. -\end_layout - -\begin_layout Subsection -Conventions used in this document -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "conventions" - -\end_inset - - -\end_layout - -\begin_layout Standard -The following typographic and usage conventions occur in this text: -\end_layout - -\begin_layout Standard -\begin_inset Tabular - - - - - - -\begin_inset Text - -\begin_layout Plain Layout -\begin_inset Caption Standard - -\begin_layout Plain Layout -Typographic and usage conventions -\end_layout - -\end_inset - - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout - -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout -Text type -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Meaning -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout -Text type -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Meaning -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout -\begin_inset Quotes eld -\end_inset - -Quoted text -\begin_inset Quotes erd -\end_inset - - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Quotes from people, quoted computer output. -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout -terminal view -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Literal computer input and output captured from the terminal. -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout - -\family typewriter -command -\family default - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Name of a command that can be entered on the command line. -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout - -\family typewriter -option -\family default - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Option to a command, as in -\begin_inset Quotes eld -\end_inset - -the -\family typewriter --a -\family default - option to the -\family typewriter -ls -\family default - command -\begin_inset Quotes erd -\end_inset - -. -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout - -\family typewriter -parameter -\family default - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Parameter to a command, as in -\begin_inset Quotes eld -\end_inset - -read -\family typewriter -man -\begin_inset space \space{} -\end_inset - -ls -\family default - -\begin_inset Quotes erd -\end_inset - -. -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout - -\family typewriter -command -\begin_inset space \space{} -\end_inset - -options -\begin_inset space \space{} -\end_inset - -arguments -\family default - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Command synopsis or general usage, on a separated line. -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout - -\family typewriter -filename -\family default - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Name of a file or directory, for example -\begin_inset Quotes eld -\end_inset - -Change to the -\family typewriter -/usr/bin -\family default - directory. -\begin_inset Quotes erd -\end_inset - - -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - -{ -\end_layout - -\end_inset - -Menu -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - - -\backslash -textgreater -\end_layout - -\end_inset - - -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - -{} -\end_layout - -\end_inset - - Choice -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - -} -\end_layout - -\end_inset - - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Choice to select from a graphical menu, for instance: -\begin_inset Quotes eld -\end_inset - -Select -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - -{ -\end_layout - -\end_inset - -Help -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - - -\backslash -textgreater -\end_layout - -\end_inset - - -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - -{} -\end_layout - -\end_inset - - About Mozilla -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - -} -\end_layout - -\end_inset - - in your browser. -\begin_inset Quotes erd -\end_inset - - -\end_layout - -\end_inset - - - - -\begin_inset Text - -\begin_layout Plain Layout -\begin_inset CommandInset href -LatexCommand href -name "The author" -target "http://www.xtrinsic.com" - -\end_inset - - -\end_layout - -\end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -Click-able link to an external web resource. -\end_layout - -\end_inset - - - - -\end_inset - - -\end_layout - -\begin_layout Standard -Thanks to Machtelt -\begin_inset Quotes eld -\end_inset - -Tille -\begin_inset Quotes erd -\end_inset - - Garrels for this list of conventions. -\end_layout - -\begin_layout Section -About My Topic -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "about" - -\end_inset - - -\end_layout - -\begin_layout Standard -Start by explaining the basics of your topic. - Is a brief history lesson in order? -\end_layout - -\begin_layout Subsection -Distribution News -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "distro-news" - -\end_inset - - -\end_layout - -\begin_layout Standard -If there is any news specific to each of the distrobutions of Linux, you - can include it here. -\end_layout - -\begin_layout Section -Installing from scratch -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "install" - -\end_inset - - -\end_layout - -\begin_layout Standard -Write down each of the steps on how to install any necessary packages/software/e -tc. - Do you need to recompile the kernel to activate new options? -\end_layout - -\begin_layout Standard -If there are any step-by-step instructions, you may want to include them - in an example so that they can be easily referred to later. -\end_layout - -\begin_layout Standard -\begin_inset FormulaMacro -\newcommand{\labelenumi}{\arabic{enumi}.} -\end_inset - - -\end_layout - -\begin_layout Enumerate -Step One. - -\end_layout - -\begin_layout Enumerate -Step Two. - -\end_layout - -\begin_layout Enumerate -Step Three. - -\end_layout - -\begin_layout Section -Using SOFTWARE -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "using-softwarepackage" - -\end_inset - - -\end_layout - -\begin_layout Standard -Finally! Now you can describe how to use your system/software/package. -\end_layout - -\begin_layout Standard -APPENDIX -\end_layout - -\begin_layout Section -GNU Free Documentation License -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl" - -\end_inset - - -\end_layout - -\begin_layout Section -GNU Free Documentation License -\end_layout - -\begin_layout Standard -Version 1.1, March 2000 -\end_layout - -\begin_layout Quote -Copyright (C) 2000 Free Software Foundation, Inc. - 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted - to copy and distribute verbatim copies of this license document, but changing - it is not allowed. - -\end_layout - -\begin_layout Section -PREAMBLE -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-0" - -\end_inset - - -\end_layout - -\begin_layout Standard -The purpose of this License is to make a manual, textbook, or other written - document ''free'' in the sense of freedom: to assure everyone the effective - freedom to copy and redistribute it, with or without modifying it, either - commercially or noncommercially. - Secondarily, this License preserves for the author and publisher a way - to get credit for their work, while not being considered responsible for - modifications made by others. -\end_layout - -\begin_layout Standard -This License is a kind of ''copyleft'', which means that derivative works - of the document must themselves be free in the same sense. - It complements the GNU General Public License, which is a copyleft license - designed for free software. -\end_layout - -\begin_layout Standard -We have designed this License in order to use it for manuals for free software, - because free software needs free documentation: a free program should come - with manuals providing the same freedoms that the software does. - But this License is not limited to software manuals; it can be used for - any textual work, regardless of subject matter or whether it is published - as a printed book. - We recommend this License principally for works whose purpose is instruction - or reference. -\end_layout - -\begin_layout Section -APPLICABILITY AND DEFINITIONS -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-1" - -\end_inset - - -\end_layout - -\begin_layout Standard -This License applies to any manual or other work that contains a notice - placed by the copyright holder saying it can be distributed under the terms - of this License. - The ''Document'', below, refers to any such manual or work. - Any member of the public is a licensee, and is addressed as you''. -\end_layout - -\begin_layout Standard -A ''Modified Version'' of the Document means any work containing the Document - or a portion of it, either copied verbatim, or with modifications and/or - translated into another language. -\end_layout - -\begin_layout Standard -A ''Secondary Section'' is a named appendix or a front-matter section of - the Document that deals exclusively with the relationship of the publishers - or authors of the Document to the Document's overall subject (or to related - matters) and contains nothing that could fall directly within that overall - subject. - (For example, if the Document is in part a textbook of mathematics, a Secondary - Section may not explain any mathematics.) The relationship could be a matter - of historical connection with the subject or with related matters, or of - legal, commercial, philosophical, ethical or political position regarding - them. -\end_layout - -\begin_layout Standard -The ''Invariant Sections'' are certain Secondary Sections whose titles are - designated, as being those of Invariant Sections, in the notice that says - that the Document is released under this License. -\end_layout - -\begin_layout Standard -The ''Cover Texts'' are certain short passages of text that are listed, - as Front-Cover Texts or Back-Cover Texts, in the notice that says that - the Document is released under this License. -\end_layout - -\begin_layout Standard -A ''Transparent'' copy of the Document means a machine-readable copy, represente -d in a format whose specification is available to the general public, whose - contents can be viewed and edited directly and straightforwardly with generic - text editors or (for images composed of pixels) generic paint programs - or (for drawings) some widely available drawing editor, and that is suitable - for input to text formatters or for automatic translation to a variety - of formats suitable for input to text formatters. - A copy made in an otherwise Transparent file format whose markup has been - designed to thwart or discourage subsequent modification by readers is - not Transparent. - A copy that is not ''Transparent'' is called ''Opaque''. -\end_layout - -\begin_layout Standard -Examples of suitable formats for Transparent copies include plain ASCII - without markup, Texinfo input format, -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - -LaTeX -\end_layout - -\end_inset - - input format, SGML or XML using a publicly available DTD, and standard-conformi -ng simple HTML designed for human modification. - Opaque formats include PostScript, PDF, proprietary formats that can be - read and edited only by proprietary word processors, SGML or XML for which - the DTD and/or processing tools are not generally available, and the machine-ge -nerated HTML produced by some word processors for output purposes only. -\end_layout - -\begin_layout Standard -The ''Title Page'' means, for a printed book, the title page itself, plus - such following pages as are needed to hold, legibly, the material this - License requires to appear in the title page. - For works in formats which do not have any title page as such, ''Title - Page'' means the text near the most prominent appearance of the work's - title, preceding the beginning of the body of the text. -\end_layout - -\begin_layout Section -VERBATIM COPYING -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-2" - -\end_inset - - -\end_layout - -\begin_layout Standard -You may copy and distribute the Document in any medium, either commercially - or noncommercially, provided that this License, the copyright notices, - and the license notice saying this License applies to the Document are - reproduced in all copies, and that you add no other conditions whatsoever - to those of this License. - You may not use technical measures to obstruct or control the reading or - further copying of the copies you make or distribute. - However, you may accept compensation in exchange for copies. - If you distribute a large enough number of copies you must also follow - the conditions in section 3. -\end_layout - -\begin_layout Standard -You may also lend copies, under the same conditions stated above, and you - may publicly display copies. -\end_layout - -\begin_layout Section -COPYING IN QUANTITY -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-3" - -\end_inset - - -\end_layout - -\begin_layout Standard -If you publish printed copies of the Document numbering more than 100, and - the Document's license notice requires Cover Texts, you must enclose the - copies in covers that carry, clearly and legibly, all these Cover Texts: - Front-Cover Texts on the front cover, and Back-Cover Texts on the back - cover. - Both covers must also clearly and legibly identify you as the publisher - of these copies. - The front cover must present the full title with all words of the title - equally prominent and visible. - You may add other material on the covers in addition. - Copying with changes limited to the covers, as long as they preserve the - title of the Document and satisfy these conditions, can be treated as verbatim - copying in other respects. -\end_layout - -\begin_layout Standard -If the required texts for either cover are too voluminous to fit legibly, - you should put the first ones listed (as many as fit reasonably) on the - actual cover, and continue the rest onto adjacent pages. -\end_layout - -\begin_layout Standard -If you publish or distribute Opaque copies of the Document numbering more - than 100, you must either include a machine-readable Transparent copy along - with each Opaque copy, or state in or with each Opaque copy a publicly-accessib -le computer-network location containing a complete Transparent copy of the - Document, free of added material, which the general network-using public - has access to download anonymously at no charge using public-standard network - protocols. - If you use the latter option, you must take reasonably prudent steps, when - you begin distribution of Opaque copies in quantity, to ensure that this - Transparent copy will remain thus accessible at the stated location until - at least one year after the last time you distribute an Opaque copy (directly - or through your agents or retailers) of that edition to the public. -\end_layout - -\begin_layout Standard -It is requested, but not required, that you contact the authors of the Document - well before redistributing any large number of copies, to give them a chance - to provide you with an updated version of the Document. -\end_layout - -\begin_layout Section -MODIFICATIONS -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-4" - -\end_inset - - -\end_layout - -\begin_layout Standard -You may copy and distribute a Modified Version of the Document under the - conditions of sections 2 and 3 above, provided that you release the Modified - Version under precisely this License, with the Modified Version filling - the role of the Document, thus licensing distribution and modification - of the Modified Version to whoever possesses a copy of it. - In addition, you must do these things in the Modified Version: -\end_layout - -\begin_layout Standard -\begin_inset FormulaMacro -\renewcommand{\labelenumi}{\Alph{enumi}.} -\end_inset - - -\end_layout - -\begin_layout Enumerate -Use in the Title Page (and on the covers, if any) a title distinct from - that of the Document, and from those of previous versions (which should, - if there were any, be listed in the History section of the Document). - You may use the same title as a previous version if the original publisher - of that version gives permission. - -\end_layout - -\begin_layout Enumerate -List on the Title Page, as authors, one or more persons or entities responsible - for authorship of the modifications in the Modified Version, together with - at least five of the principal authors of the Document (all of its principal - authors, if it has less than five). - -\end_layout - -\begin_layout Enumerate -State on the Title page the name of the publisher of the Modified Version, - as the publisher. - -\end_layout - -\begin_layout Enumerate -Preserve all the copyright notices of the Document. - -\end_layout - -\begin_layout Enumerate -Add an appropriate copyright notice for your modifications adjacent to the - other copyright notices. - -\end_layout - -\begin_layout Enumerate -Include, immediately after the copyright notices, a license notice giving - the public permission to use the Modified Version under the terms of this - License, in the form shown in the Addendum below. - -\end_layout - -\begin_layout Enumerate -Preserve in that license notice the full lists of Invariant Sections and - required Cover Texts given in the Document's license notice. - -\end_layout - -\begin_layout Enumerate -Include an unaltered copy of this License. - -\end_layout - -\begin_layout Enumerate -Preserve the section entitled ''History'', and its title, and add to it - an item stating at least the title, year, new authors, and publisher of - the Modified Version as given on the Title Page. - If there is no section entitled ''History'' in the Document, create one - stating the title, year, authors, and publisher of the Document as given - on its Title Page, then add an item describing the Modified Version as - stated in the previous sentence. - -\end_layout - -\begin_layout Enumerate -Preserve the network location, if any, given in the Document for public - access to a Transparent copy of the Document, and likewise the network - locations given in the Document for previous versions it was based on. - These may be placed in the ''History'' section. - You may omit a network location for a work that was published at least - four years before the Document itself, or if the original publisher of - the version it refers to gives permission. - -\end_layout - -\begin_layout Enumerate -In any section entitled ''Acknowledgements'' or ''Dedications'', preserve - the section's title, and preserve in the section all the substance and - tone of each of the contributor acknowledgements and/or dedications given - therein. - -\end_layout - -\begin_layout Enumerate -Preserve all the Invariant Sections of the Document, unaltered in their - text and in their titles. - Section numbers or the equivalent are not considered part of the section - titles. - -\end_layout - -\begin_layout Enumerate -Delete any section entitled ''Endorsements''. - Such a section may not be included in the Modified Version. - -\end_layout - -\begin_layout Enumerate -Do not retitle any existing section as ''Endorsements'' or to conflict in - title with any Invariant Section. - -\end_layout - -\begin_layout Standard -If the Modified Version includes new front-matter sections or appendices - that qualify as Secondary Sections and contain no material copied from - the Document, you may at your option designate some or all of these sections - as invariant. - To do this, add their titles to the list of Invariant Sections in the Modified - Version's license notice. - These titles must be distinct from any other section titles. -\end_layout - -\begin_layout Standard -You may add a section entitled ''Endorsements'', provided it contains nothing - but endorsements of your Modified Version by various parties- -\begin_inset ERT -status collapsed - -\begin_layout Plain Layout - - -\backslash -/ -\end_layout - -\end_inset - --for example, statements of peer review or that the text has been approved - by an organization as the authoritative definition of a standard. -\end_layout - -\begin_layout Standard -You may add a passage of up to five words as a Front-Cover Text, and a passage - of up to 25 words as a Back-Cover Text, to the end of the list of Cover - Texts in the Modified Version. - Only one passage of Front-Cover Text and one of Back-Cover Text may be - added by (or through arrangements made by) any one entity. - If the Document already includes a cover text for the same cover, previously - added by you or by arrangement made by the same entity you are acting on - behalf of, you may not add another; but you may replace the old one, on - explicit permission from the previous publisher that added the old one. -\end_layout - -\begin_layout Standard -The author(s) and publisher(s) of the Document do not by this License give - permission to use their names for publicity for or to assert or imply endorseme -nt of any Modified Version. -\end_layout - -\begin_layout Section -COMBINING DOCUMENTS -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-5" - -\end_inset - - -\end_layout - -\begin_layout Standard -You may combine the Document with other documents released under this License, - under the terms defined in section 4 above for modified versions, provided - that you include in the combination all of the Invariant Sections of all - of the original documents, unmodified, and list them all as Invariant Sections - of your combined work in its license notice. -\end_layout - -\begin_layout Standard -The combined work need only contain one copy of this License, and multiple - identical Invariant Sections may be replaced with a single copy. - If there are multiple Invariant Sections with the same name but different - contents, make the title of each such section unique by adding at the end - of it, in parentheses, the name of the original author or publisher of - that section if known, or else a unique number. - Make the same adjustment to the section titles in the list of Invariant - Sections in the license notice of the combined work. -\end_layout - -\begin_layout Standard -In the combination, you must combine any sections entitled ''History'' in - the various original documents, forming one section entitled ''History''; - likewise combine any sections entitled ''Acknowledgements'', and any sections - entitled ''Dedications''. - You must delete all sections entitled ''Endorsements.'' -\end_layout - -\begin_layout Section -COLLECTIONS OF DOCUMENTS -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-6" - -\end_inset - - -\end_layout - -\begin_layout Standard -You may make a collection consisting of the Document and other documents - released under this License, and replace the individual copies of this - License in the various documents with a single copy that is included in - the collection, provided that you follow the rules of this License for - verbatim copying of each of the documents in all other respects. -\end_layout - -\begin_layout Standard -You may extract a single document from such a collection, and distribute - it individually under this License, provided you insert a copy of this - License into the extracted document, and follow this License in all other - respects regarding verbatim copying of that document. -\end_layout - -\begin_layout Section -AGGREGATION WITH INDEPENDENT WORKS -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-7" - -\end_inset - - -\end_layout - -\begin_layout Standard -A compilation of the Document or its derivatives with other separate and - independent documents or works, in or on a volume of a storage or distribution - medium, does not as a whole count as a Modified Version of the Document, - provided no compilation copyright is claimed for the compilation. - Such a compilation is called an ''aggregate'', and this License does not - apply to the other self-contained works thus compiled with the Document, - on account of their being thus compiled, if they are not themselves derivative - works of the Document. -\end_layout - -\begin_layout Standard -If the Cover Text requirement of section 3 is applicable to these copies - of the Document, then if the Document is less than one quarter of the entire - aggregate, the Document's Cover Texts may be placed on covers that surround - only the Document within the aggregate. - Otherwise they must appear on covers around the whole aggregate. -\end_layout - -\begin_layout Section -TRANSLATION -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-8" - -\end_inset - - -\end_layout - -\begin_layout Standard -Translation is considered a kind of modification, so you may distribute - translations of the Document under the terms of section 4. - Replacing Invariant Sections with translations requires special permission - from their copyright holders, but you may include translations of some - or all Invariant Sections in addition to the original versions of these - Invariant Sections. - You may include a translation of this License provided that you also include - the original English version of this License. - In case of a disagreement between the translation and the original English - version of this License, the original English version will prevail. -\end_layout - -\begin_layout Section -TERMINATION -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-9" - -\end_inset - - -\end_layout - -\begin_layout Standard -You may not copy, modify, sublicense, or distribute the Document except - as expressly provided for under this License. - Any other attempt to copy, modify, sublicense or distribute the Document - is void, and will automatically terminate your rights under this License. - However, parties who have received copies, or rights, from you under this - License will not have their licenses terminated so long as such parties - remain in full compliance. -\end_layout - -\begin_layout Section -FUTURE REVISIONS OF THIS LICENSE -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-10" - -\end_inset - - -\end_layout - -\begin_layout Standard -The Free Software Foundation may publish new, revised versions of the GNU - Free Documentation License from time to time. - Such new versions will be similar in spirit to the present version, but - may differ in detail to address new problems or concerns. - See -\begin_inset Flex Flex:URL -status collapsed - -\begin_layout Plain Layout - -http://www.gnu.org/copyleft/ -\end_layout - -\end_inset - -. -\end_layout - -\begin_layout Standard -Each version of the License is given a distinguishing version number. - If the Document specifies that a particular numbered version of this License - ''or any later version'' applies to it, you have the option of following - the terms and conditions either of that specified version or of any later - version that has been published (not as a draft) by the Free Software Foundatio -n. - If the Document does not specify a version number of this License, you - may choose any version ever published (not as a draft) by the Free Software - Foundation. -\end_layout - -\begin_layout Section -How to use this License for your documents -\end_layout - -\begin_layout Standard -\begin_inset CommandInset label -LatexCommand label -name "gfdl-11" - -\end_inset - - -\end_layout - -\begin_layout Standard -To use this License in a document you have written, include a copy of the - License in the document and put the following copyright and license notices - just after the title page: -\end_layout - -\begin_layout Quote -Copyright (c) YEAR YOUR NAME. - Permission is granted to copy, distribute and/or modify this document under - the terms of the GNU Free Documentation License, Version 1.1 or any later - version published by the Free Software Foundation; with the Invariant Sections - being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with - the Back-Cover Texts being LIST. - A copy of the license is included in the section entitled ''GNU Free Documentat -ion License''. - -\end_layout - -\begin_layout Standard -If you have no Invariant Sections, write ''with no Invariant Sections'' - instead of saying which ones are invariant. - If you have no Front-Cover Texts, write ''no Front-Cover Texts'' instead - of ''Front-Cover Texts being LIST''; likewise for Back-Cover Texts. -\end_layout - -\begin_layout Standard -If your document contains nontrivial examples of program code, we recommend - releasing these examples in parallel under your choice of free software - license, such as the GNU General Public License, to permit their use in - free software. -\end_layout - -\end_body -\end_document From dbf23c82be0212f6a992569c3f6e77639ad0b207 Mon Sep 17 00:00:00 2001 From: tgeek77 Date: Sun, 17 Jan 2016 20:31:55 +0100 Subject: [PATCH 06/10] updated working copy --- .../Jason-Evans/Github and TLDP-howto.lyx | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) diff --git a/LDP/users/Jason-Evans/Github and TLDP-howto.lyx b/LDP/users/Jason-Evans/Github and TLDP-howto.lyx index 55f5031d..48957c3d 100644 --- a/LDP/users/Jason-Evans/Github and TLDP-howto.lyx +++ b/LDP/users/Jason-Evans/Github and TLDP-howto.lyx @@ -200,6 +200,58 @@ In the past, The Linux Documentation Project used CVS as a version control accompanying documentation for adding new material to TLDP \end_layout +\begin_layout Section +Basic Terminology and Commands +\end_layout + +\begin_layout Standard +Push +\end_layout + +\begin_layout Standard +Pull +\end_layout + +\begin_layout Standard +Commit +\end_layout + +\begin_layout Standard +Branch +\end_layout + +\begin_layout Standard +Repository +\end_layout + +\begin_layout Standard +Fork +\end_layout + +\begin_layout Standard +Clone +\end_layout + +\begin_layout Standard +Diff +\end_layout + +\begin_layout Standard +Fetch +\end_layout + +\begin_layout Section +What is Git and GutHub? +\end_layout + +\begin_layout Subsection +What is Git? +\end_layout + +\begin_layout Subsection +What does GitHub do? +\end_layout + \begin_layout Section Installing Git \end_layout From 446725e77583fb56ad6eea64caf1051f56c8ab7f Mon Sep 17 00:00:00 2001 From: tgeek77 Date: Sun, 17 Jan 2016 21:24:13 +0100 Subject: [PATCH 07/10] working file --- LDP/users/Jason-Evans/Github and TLDP-howto.lyx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/LDP/users/Jason-Evans/Github and TLDP-howto.lyx b/LDP/users/Jason-Evans/Github and TLDP-howto.lyx index 48957c3d..f93465be 100644 --- a/LDP/users/Jason-Evans/Github and TLDP-howto.lyx +++ b/LDP/users/Jason-Evans/Github and TLDP-howto.lyx @@ -261,7 +261,6 @@ From Ubuntu or Debian \end_layout \begin_layout Code - $ sudo apt-get install git \end_layout @@ -270,7 +269,6 @@ From Fedora, CentOS, or RHEL \end_layout \begin_layout Code - $ sudo yum install git \end_layout @@ -279,7 +277,6 @@ From Fedora 23 or later \end_layout \begin_layout Code - $ sudo dnf install git \end_layout @@ -288,7 +285,6 @@ From OpenSuSE or SLES \end_layout \begin_layout Code - $ sudo zypper install git \end_layout From fde85030888d2d8dab7e3eb339d7997a03d2a418 Mon Sep 17 00:00:00 2001 From: Karel Vlk Date: Tue, 19 Jan 2016 15:15:09 +0100 Subject: [PATCH 08/10] fix homophonic typo "principal"/"principle" typo --- LDP/guide/docbook/Bash-Beginners-Guide/abook.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml b/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml index b8786096..2620cf2c 100644 --- a/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml +++ b/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml @@ -66,7 +66,7 @@
Why this guide? -The primary reason for writing this document is that a lot of readers feel the existing HOWTO to be too short and incomplete, while the Bash Scripting guide is too much of a reference work. There is nothing in between these two extremes. I also wrote this guide on the general principal that not enough free basic courses are available, though they should be. +The primary reason for writing this document is that a lot of readers feel the existing HOWTO to be too short and incomplete, while the Bash Scripting guide is too much of a reference work. There is nothing in between these two extremes. I also wrote this guide on the general principle that not enough free basic courses are available, though they should be. This is a practical guide which, while not always being too serious, tries to give real-life instead of theoretical examples. I partly wrote it because I don't get excited with stripped down and over-simplified examples written by people who know what they are talking about, showing some really cool Bash feature so much out of its context that you cannot ever use it in practical circumstances. You can read that sort of stuff after finishing this book, which contains exercises and examples that will help you survive in the real world. From my experience as UNIX/Linux user, system administrator and trainer, I know that people can have years of daily interaction with their systems, without having the slightest knowledge of task automation. Thus they often think that UNIX is not userfriendly, and even worse, they get the impression that it is slow and old-fashioned. This problem is another one that can be remedied by this guide. From 0e968efa356ef37257e800073364b8f92ea29ffe Mon Sep 17 00:00:00 2001 From: Karel Vlk Date: Tue, 19 Jan 2016 15:32:32 +0100 Subject: [PATCH 09/10] add hyphen add a hyphen between "user" and "friendly" in "userfriendly" --- LDP/guide/docbook/Bash-Beginners-Guide/abook.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml b/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml index b8786096..5e42f40a 100644 --- a/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml +++ b/LDP/guide/docbook/Bash-Beginners-Guide/abook.xml @@ -68,7 +68,7 @@ The primary reason for writing this document is that a lot of readers feel the existing HOWTO to be too short and incomplete, while the Bash Scripting guide is too much of a reference work. There is nothing in between these two extremes. I also wrote this guide on the general principal that not enough free basic courses are available, though they should be. This is a practical guide which, while not always being too serious, tries to give real-life instead of theoretical examples. I partly wrote it because I don't get excited with stripped down and over-simplified examples written by people who know what they are talking about, showing some really cool Bash feature so much out of its context that you cannot ever use it in practical circumstances. You can read that sort of stuff after finishing this book, which contains exercises and examples that will help you survive in the real world. -From my experience as UNIX/Linux user, system administrator and trainer, I know that people can have years of daily interaction with their systems, without having the slightest knowledge of task automation. Thus they often think that UNIX is not userfriendly, and even worse, they get the impression that it is slow and old-fashioned. This problem is another one that can be remedied by this guide. +From my experience as UNIX/Linux user, system administrator and trainer, I know that people can have years of daily interaction with their systems, without having the slightest knowledge of task automation. Thus they often think that UNIX is not user-friendly, and even worse, they get the impression that it is slow and old-fashioned. This problem is another one that can be remedied by this guide.
From 9301f63a4387a5229ec1b706deb7340929fe63f1 Mon Sep 17 00:00:00 2001 From: Karel Vlk Date: Tue, 19 Jan 2016 15:49:58 +0100 Subject: [PATCH 10/10] change preposition "same as" sounds better than "same than" --- LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml b/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml index 7bd9baef..10fee1ed 100644 --- a/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml +++ b/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml @@ -157,7 +157,7 @@ All about redirection Sample: stdout 2 stderr

This will cause the stdout ouput of a program to be written to the same filedescriptor - than stderr. + as stderr. grep da * 1>&2 @@ -167,7 +167,7 @@ All about redirection Sample: stderr 2 stdout

This will cause the stderr ouput of a program to be written to the same filedescriptor - than stdout. + as stdout. grep * 2>&1