From 8cbf688a880ff47540aca9694d32229603a66d5f Mon Sep 17 00:00:00 2001 From: "Jason S. Evans" Date: Thu, 4 Feb 2016 19:10:47 +0100 Subject: [PATCH 1/4] Moved document from guides directory to howto direction and renamed file to match the standard naming convention. --- .../Package-Management-Basics/Package-Management-Basics.xml} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename LDP/{guide/docbook/Package-Management-Basics/Package Management Basics.xml => howto/docbook/Package-Management-Basics/Package-Management-Basics.xml} (100%) diff --git a/LDP/guide/docbook/Package-Management-Basics/Package Management Basics.xml b/LDP/howto/docbook/Package-Management-Basics/Package-Management-Basics.xml similarity index 100% rename from LDP/guide/docbook/Package-Management-Basics/Package Management Basics.xml rename to LDP/howto/docbook/Package-Management-Basics/Package-Management-Basics.xml From 14e6e10ae419ac8a8a4872b4d78e4f5468877699 Mon Sep 17 00:00:00 2001 From: "Jason S. Evans" Date: Sun, 7 Feb 2016 09:19:32 +0100 Subject: [PATCH 2/4] Basic housecleaning and removed excessive files --- .../Package Management Basics.lyx | 3210 +++++++++++++++++ .../Package-Management-Basics.xml | 0 ...{ldp-glossary.xml.lyx => ldp-appendix.lyx} | 92 +- .../Templates/Howto/ldp-appendix.xml | 33 - .../Templates/Howto/ldp-appendix.xml.tex | 29 - .../Templates/Howto/ldp-appendix.xml.txt | 21 - .../Templates/Howto/ldp-bibliography.lyx | 208 ++ .../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 | 10 +- .../Templates/Howto/ldp-glossary.xml | 86 - .../Templates/Howto/ldp-glossary.xml.tex | 35 - .../Templates/Howto/ldp-glossary.xml.txt | 98 - .../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 --- 18 files changed, 3483 insertions(+), 3505 deletions(-) create mode 100644 LDP/howto/docbook/Package-Management-Basics-HOWTO/Package Management Basics.lyx rename LDP/howto/docbook/{Package-Management-Basics => Package-Management-Basics-HOWTO}/Package-Management-Basics.xml (100%) rename LDP/users/Jason-Evans/Templates/Howto/{ldp-glossary.xml.lyx => ldp-appendix.lyx} (60%) delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.txt create mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.lyx delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.txt delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.txt delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.lyx delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.txt diff --git a/LDP/howto/docbook/Package-Management-Basics-HOWTO/Package Management Basics.lyx b/LDP/howto/docbook/Package-Management-Basics-HOWTO/Package Management Basics.lyx new file mode 100644 index 00000000..77761655 --- /dev/null +++ b/LDP/howto/docbook/Package-Management-Basics-HOWTO/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/howto/docbook/Package-Management-Basics/Package-Management-Basics.xml b/LDP/howto/docbook/Package-Management-Basics-HOWTO/Package-Management-Basics.xml similarity index 100% rename from LDP/howto/docbook/Package-Management-Basics/Package-Management-Basics.xml rename to LDP/howto/docbook/Package-Management-Basics-HOWTO/Package-Management-Basics.xml diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.lyx b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.lyx similarity index 60% rename from LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.lyx rename to LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.lyx index 19d50c14..81f2d597 100644 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.lyx +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.lyx @@ -1,4 +1,4 @@ -#LyX file created by tex2lyx 2.1 +#LyX 2.1 created this file. For more info see http://www.lyx.org/ \lyxformat 474 \begin_document \begin_header @@ -70,14 +70,13 @@ \begin_body \begin_layout Section -Glossary +Appendix one title \end_layout \begin_layout Standard - \begin_inset CommandInset label LatexCommand label -name "glossary" +name "app1" \end_inset @@ -85,55 +84,86 @@ name "glossary" \end_layout \begin_layout Quote -This is a glossary. +Says what this appendix is about, for instance further info on the web. + \end_layout -\begin_layout Description -entryname definition +\begin_layout Section +further info \end_layout -\begin_layout Description -entryname definition +\begin_layout Subsection +about this subject \end_layout -\begin_layout Description -entryname definition +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +target "http://useful.org" + +\end_inset + +: about this and that. + \end_layout -\begin_layout --Separator-- +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +target "http://related.org" +\end_inset + +: about other related stuff. + \end_layout -\begin_layout Description -entryname definition +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +target "http://other.org" + +\end_inset + +: more stuff. + \end_layout -\begin_layout Description -entryname definition +\begin_layout Subsection +about other subject \end_layout -\begin_layout Description -entryname definition +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +target "http://useful2.org" + +\end_inset + +: about this and that. + \end_layout -\begin_layout --Separator-- +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +target "http://related2.org" +\end_inset + +: about other related stuff. + \end_layout -\begin_layout Description -entryname definition -\end_layout +\begin_layout Itemize +\begin_inset CommandInset href +LatexCommand href +target "http://other2.org" -\begin_layout Description -entryname definition -\end_layout +\end_inset -\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. +: more stuff. + \end_layout \end_body diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml deleted file mode 100644 index 4e64c648..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml +++ /dev/null @@ -1,33 +0,0 @@ - - -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 deleted file mode 100644 index 017d8d15..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.tex +++ /dev/null @@ -1,29 +0,0 @@ -\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 deleted file mode 100644 index 2457bf88..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-appendix.xml.txt +++ /dev/null @@ -1,21 +0,0 @@ -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.lyx b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.lyx new file mode 100644 index 00000000..8b9421d9 --- /dev/null +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.lyx @@ -0,0 +1,208 @@ +#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 "F" for full when you download your kernel source. + +\end_layout + +\end_body +\end_document diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml deleted file mode 100644 index f46c042d..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml +++ /dev/null @@ -1,68 +0,0 @@ - - -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 deleted file mode 100644 index f4c20ef7..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.tex +++ /dev/null @@ -1,26 +0,0 @@ -\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 deleted file mode 100644 index 6d466f96..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-bibliography.xml.txt +++ /dev/null @@ -1,49 +0,0 @@ -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 index 7a9aa7fb..19d50c14 100644 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.lyx +++ b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.lyx @@ -1,4 +1,4 @@ -#LyX 2.1 created this file. For more info see http://www.lyx.org/ +#LyX file created by tex2lyx 2.1 \lyxformat 474 \begin_document \begin_header @@ -74,6 +74,7 @@ Glossary \end_layout \begin_layout Standard + \begin_inset CommandInset label LatexCommand label name "glossary" @@ -84,8 +85,7 @@ name "glossary" \end_layout \begin_layout Quote -This is a glossary. - +This is a glossary. \end_layout \begin_layout Description @@ -133,9 +133,7 @@ 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. - +And so on, for all the letters in the alphabet and all the items you want in the list. \end_layout \end_body diff --git a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml deleted file mode 100644 index 33715414..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml +++ /dev/null @@ -1,86 +0,0 @@ - - -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.tex b/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.tex deleted file mode 100644 index 5698f7e7..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.tex +++ /dev/null @@ -1,35 +0,0 @@ -\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 deleted file mode 100644 index d9bce5b0..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-glossary.xml.txt +++ /dev/null @@ -1,98 +0,0 @@ -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.xml b/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml deleted file mode 100644 index 7947a423..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml +++ /dev/null @@ -1,722 +0,0 @@ - - - - - - - - - - - - - -]> - -
- -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 deleted file mode 100644 index 4e2a7fe2..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.lyx +++ /dev/null @@ -1,1237 +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 -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 deleted file mode 100644 index 4740c0ce..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.tex +++ /dev/null @@ -1,473 +0,0 @@ -\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 deleted file mode 100644 index e03e9e5d..00000000 --- a/LDP/users/Jason-Evans/Templates/Howto/ldp-howto.xml.txt +++ /dev/null @@ -1,591 +0,0 @@ -\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 a3fcf3801d5772acca1c881aaa5fe497f69f4d4b Mon Sep 17 00:00:00 2001 From: "Jason S. Evans" Date: Sun, 7 Feb 2016 09:27:57 +0100 Subject: [PATCH 3/4] Cleaned up guide and faq templates. --- .../Jason-Evans/Templates/FAQ/ldp-faq.lyx | 2 +- .../Jason-Evans/Templates/FAQ/ldp-faq.xml | 81 ---- .../Jason-Evans/Templates/FAQ/ldp-faq.xml.tex | 15 - .../Jason-Evans/Templates/FAQ/ldp-faq.xml.txt | 79 --- ...{ldp-appendix.xml.lyx => ldp-appendix.lyx} | 0 .../Templates/Guide/ldp-appendix.xml | 33 -- .../Templates/Guide/ldp-appendix.xml.tex | 29 -- .../Templates/Guide/ldp-appendix.xml.txt | 21 - .../Templates/Guide/ldp-bibliography.xml | 68 --- .../Templates/Guide/ldp-bibliography.xml.tex | 26 - .../Templates/Guide/ldp-bibliography.xml.txt | 49 -- .../ldp-glossary.lyx} | 113 ++--- .../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.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.xml | 90 ---- .../Templates/Guide/ldp-guide-chap2.xml.lyx | 459 ------------------ .../Templates/Guide/ldp-guide-chap2.xml.tex | 92 ---- .../Templates/Guide/ldp-guide-chap2.xml.txt | 68 --- ...-guide-main.xml.lyx => ldp-guide-main.lyx} | 0 .../Templates/Guide/ldp-guide-main.xml | 253 ---------- .../Templates/Guide/ldp-guide-main.xml.tex | 125 ----- .../Templates/Guide/ldp-guide-main.xml.txt | 124 ----- 27 files changed, 59 insertions(+), 2294 deletions(-) delete mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml delete mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.txt rename LDP/users/Jason-Evans/Templates/Guide/{ldp-appendix.xml.lyx => ldp-appendix.lyx} (100%) delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.txt delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.txt rename LDP/users/Jason-Evans/Templates/{FAQ/ldp-faq.xml.lyx => Guide/ldp-glossary.lyx} (66%) delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.txt delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.lyx delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.txt delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.txt rename LDP/users/Jason-Evans/Templates/Guide/{ldp-guide-main.xml.lyx => ldp-guide-main.lyx} (100%) delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.tex delete mode 100644 LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.txt diff --git a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx index ddc71aa9..65aeec40 100644 --- a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx +++ b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.lyx @@ -1,4 +1,4 @@ -#LyX 2.1 created this file. For more info see http://www.lyx.org/ +#LyX file created by tex2lyx 2.1 \lyxformat 474 \begin_document \begin_header diff --git a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml deleted file mode 100644 index 64d56bd5..00000000 --- a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml +++ /dev/null @@ -1,81 +0,0 @@ - - -
- - 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.tex b/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.tex deleted file mode 100644 index 3c0de9e6..00000000 --- a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.tex +++ /dev/null @@ -1,15 +0,0 @@ -\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 deleted file mode 100644 index 0059c4b3..00000000 --- a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.txt +++ /dev/null @@ -1,79 +0,0 @@ -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/ldp-appendix.xml.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.lyx similarity index 100% rename from LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.lyx rename to LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.lyx diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml deleted file mode 100644 index 4e64c648..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml +++ /dev/null @@ -1,33 +0,0 @@ - - -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.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.tex deleted file mode 100644 index 017d8d15..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.tex +++ /dev/null @@ -1,29 +0,0 @@ -\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 deleted file mode 100644 index 2457bf88..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-appendix.xml.txt +++ /dev/null @@ -1,21 +0,0 @@ -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.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml deleted file mode 100644 index f46c042d..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml +++ /dev/null @@ -1,68 +0,0 @@ - - -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.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.tex deleted file mode 100644 index f4c20ef7..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.tex +++ /dev/null @@ -1,26 +0,0 @@ -\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 deleted file mode 100644 index 6d466f96..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-bibliography.xml.txt +++ /dev/null @@ -1,49 +0,0 @@ -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/FAQ/ldp-faq.xml.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.lyx similarity index 66% rename from LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.lyx rename to LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.lyx index 65aeec40..19d50c14 100644 --- a/LDP/users/Jason-Evans/Templates/FAQ/ldp-faq.xml.lyx +++ b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.lyx @@ -69,68 +69,71 @@ \begin_body -\begin_layout Standard - -\series bold -Q: -\series default - question 1 +\begin_layout Section +Glossary \end_layout \begin_layout Standard -\series bold -A: -\series default - answer 1 +\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 - -\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 +And so on, for all the letters in the alphabet and all the items you want in the list. \end_layout \end_body diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml deleted file mode 100644 index 33715414..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml +++ /dev/null @@ -1,86 +0,0 @@ - - -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 deleted file mode 100644 index 5698f7e7..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.tex +++ /dev/null @@ -1,35 +0,0 @@ -\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 deleted file mode 100644 index d9bce5b0..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-glossary.xml.txt +++ /dev/null @@ -1,98 +0,0 @@ -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.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml deleted file mode 100644 index d268e6b5..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml +++ /dev/null @@ -1,53 +0,0 @@ - -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 deleted file mode 100644 index 22bd5671..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.lyx +++ /dev/null @@ -1,255 +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 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 deleted file mode 100644 index be7558ca..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.tex +++ /dev/null @@ -1,51 +0,0 @@ -\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 deleted file mode 100644 index df30207c..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap1.xml.txt +++ /dev/null @@ -1,48 +0,0 @@ -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.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml deleted file mode 100644 index eab864d1..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml +++ /dev/null @@ -1,90 +0,0 @@ - -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 deleted file mode 100644 index e15ce572..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.lyx +++ /dev/null @@ -1,459 +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 -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.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.tex deleted file mode 100644 index 8418561b..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.tex +++ /dev/null @@ -1,92 +0,0 @@ -\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 deleted file mode 100644 index d9918c9e..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-chap2.xml.txt +++ /dev/null @@ -1,68 +0,0 @@ -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.lyx b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.lyx similarity index 100% rename from LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.lyx rename to LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.lyx diff --git a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml deleted file mode 100644 index 9ddad775..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml +++ /dev/null @@ -1,253 +0,0 @@ - - - - - - -]> - - - - 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.tex b/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.tex deleted file mode 100644 index c77e09d2..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.tex +++ /dev/null @@ -1,125 +0,0 @@ -\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 deleted file mode 100644 index a791d590..00000000 --- a/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml.txt +++ /dev/null @@ -1,124 +0,0 @@ -{]}\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; From 9da553be15f5e16c6534a0c469de84b78b8ca1a7 Mon Sep 17 00:00:00 2001 From: Brandon High Date: Tue, 9 Feb 2016 14:09:35 -0800 Subject: [PATCH 4/4] Grammar/spelling fixes for Bash Prog Intro This commit contains some minor grammatical/spelling fixes for the Bash Programming Into HOWTO. --- LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml | 455 +++++++++--------- 1 file changed, 228 insertions(+), 227 deletions(-) diff --git a/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml b/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml index 2606a095..f74b9130 100644 --- a/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml +++ b/LDP/howto/linuxdoc/Bash-Prog-Intro-HOWTO.sgml @@ -1,6 +1,6 @@ - @@ -9,16 +9,16 @@
BASH Programming - Introduction HOW-TO by Mike G - + Thu Jul 27 09:36:18 ART 2000 - - This article intends to help you to start programming - basic-intermediate shell scripts. It does not intend to be an - advanced document (see the title). I am NOT an expert nor guru - shell programmer. I decided to write this because I'll learn a - lot and it might be useful to other people. Any feedback will be apreciated, - specially in the patch form :) + + This article is intended to help you to start programming + basic-intermediate shell scripts. It does not intend to be an + advanced document (see the title). I am NOT an expert nor guru + shell programmer. I decided to write this because I'll learn a + lot and it might be useful to other people. Any feedback will is + appreciated, especially in the patch or pull request form. :) @@ -41,73 +41,73 @@ Getting the latest version Requisites -

Familiarity with GNU/Linux command lines, and familiarity +

Familiarity with GNU/Linux command lines, and familiarity with basic programming concepts is helpful. While this is not a programming introduction, it explains (or at least tries) many basic concepts. -

+

Uses of this document

This document tries to be useful in the following situations - You have an idea about programming and you want to start + You have an idea about programming and you want to start coding some shell scripts. - You have a vague idea about shell programming and want + You have a vague idea about shell programming and want some sort of reference. You want to see some shell scripts and some comments to - start writing your own - You are migrating from DOS/Windows (or already did) + start writing your own. + You are migrating from DOS/Windows (or already did) and want to make "batch" processes. - You are a complete nerd and read every how-to available + You are a complete nerd and read every how-to available. - + Very simple Scripts

This HOW-TO will try to give you some hints about shell script programming strongly based on examples. -

In this section you'll find some little scripts which +

In this section you'll find some little scripts which will hopefully help you to understand some techniques. Traditional hello world script

- #!/bin/bash - echo Hello World + #!/bin/bash + echo Hello World -

-

This script has only two lines. - The first indicates the system which program - to use to run the file. -

The second line is the only action performed by this script, +

+

This script has only two lines. + The first indicates the system which program + to use to run the file. +

The second line is the only action performed by this script, which prints 'Hello World' on the terminal.

If you get something like ./hello.sh: Command not found. - Probably the first line '#!/bin/bash' is wrong, issue whereis bash or see - 'finding bash' to see how sould you write this line. + Probably the first line '#!/bin/bash' is wrong, issue whereis bash or see + 'finding bash' to see how should you write this line. A very simple backup script

- #!/bin/bash + #!/bin/bash tar -cZf /var/my-backup.tgz /home/me/ -

In this script, instead of printing a message on the terminal, +

In this script, instead of printing a message on the terminal, we create a tar-ball of a user's home directory. This is NOT intended - to be used, a more useful backup script is presented later in this + to be used, a more useful backup script is presented later in this document. - + @@ -122,31 +122,32 @@ All about redirection redirect stdout to a file redirect stderr to a file - redirect stdout to a stderr - redirect stderr to a stdout - redirect stderr and stdout to a file - redirect stderr and stdout to stdout + redirect stdout to a stderr + redirect stderr to a stdout + redirect stderr and stdout to a file + redirect stderr and stdout to stdout redirect stderr and stdout to stderr 1 'represents' stdout and 2 stderr. -

A little note for seeing this things: with the less command you can view both stdout - (which will remain on the buffer) and the stderr that will be printed on the screen, but erased as - you try to 'browse' the buffer. +

A little note for seeing the output of these commands: with the less + command you can view both stdout (which will remain on the buffer) and the + stderr that will be printed on the screen, but erased as you try to 'browse' + the buffer. - + - Sample: stdout 2 file -

This will cause the ouput of a program to be written to a file. + Sample: stdout 2 file +

This will cause the output of a program to be written to a file. ls -l > ls-l.txt - Here, a file called 'ls-l.txt' will be created and it will contain what you would see on the + Here, a file called 'ls-l.txt' will be created and it will contain what you would see on the screen if you type the command 'ls -l' and execute it. - Sample: stderr 2 file -

This will cause the stderr ouput of a program to be written to a file. + Sample: stderr 2 file +

This will cause the stderr output of a program to be written to a file. grep da * 2> grep-errors.txt @@ -156,38 +157,38 @@ All about redirection Sample: stdout 2 stderr -

This will cause the stdout ouput of a program to be written to the same filedescriptor +

This will cause the stdout output of a program to be written to the same filedescriptor as stderr. - grep da * 1>&2 + grep da * 1>&2 - Here, the stdout portion of the command is sent to stderr, you may notice that in differen ways. + Here, the stdout portion of the command is sent to stderr, you may notice that in different ways. - Sample: stderr 2 stdout -

This will cause the stderr ouput of a program to be written to the same filedescriptor + Sample: stderr 2 stdout +

This will cause the stderr output of a program to be written to the same filedescriptor as stdout. grep * 2>&1 Here, the stderr portion of the command is sent to stdout, if you pipe to less, you'll see that - lines that normally 'dissapear' (as they are written to stderr) are being kept now (because - they're on stdout). + lines that normally 'disappear' (as they are written to stderr) are being kept now (because + they're on stdout). - Sample: stderr and stdout 2 file -

This will place every output of a program to a file. This is suitable sometimes - for cron entries, if you want a command to pass in absolute silence. + Sample: stderr and stdout 2 file +

This will place every output of a program to a file. This is suitable sometimes + for cron entries, if you want a command to pass in absolute silence. - rm -f $(find / -name core) &> /dev/null + rm -f $(find / -name core) &> /dev/null This (thinking on the cron entry) will delete every file called 'core' in any directory. Notice - that you should be pretty sure of what a command is doing if you are going to wipe it's output. + that you should be pretty sure of what a command is doing if you are going to wipe it's output. @@ -195,8 +196,8 @@ redirect stderr and stdout to stderr Pipes -

This section explains in a very simple and practical way how to use pipes, - nd why you may want it. +

This section explains in a very simple and practical way how to use pipes, + and why you may want to use them. What they are and why you'll want to use them -

Pipes let you use (very simple, I insist) the output of a program as the - input of another one +

Pipes let you use (very simple, I insist) the output of a program as the + input of another one - Sample: simple pipe with sed + Sample: simple pipe with sed

This is very simple way to use pipes. - ls -l | sed -e "s/[aeio]/u/g" + ls -l | sed -e "s/[aeio]/u/g" - Here, the following happens: first the command ls -l is executed, and it's output, + Here, the following happens: first the command ls -l is executed, and its output, instead of being printed, is sent (piped) to the sed program, which in turn, prints - what it has to. + what it has to. - Sample: an alternative to ls -l *.txt + Sample: an alternative to ls -l *.txt

Probably, this is a more difficult way to do ls -l *.txt, but it is here for illustrating pipes, - not for solving such listing dilema. + not for solving such listing dillema. ls -l | grep "\.txt$" - Here, the output of the program ls -l is sent to the grep program, which, in turn, will print + Here, the output of the program ls -l is sent to the grep program, which, in turn, will print lines which match the regex "\.txt$". @@ -245,8 +246,8 @@ Pipes -

You can use variables as in any programming languages. +

You can use variables as in any programming languages. There are no data types. A variable in bash can contain a number, a - character, a string of characters. -

You have no need to declare a variable, just + character, a string of characters. +

You have no need to declare a variable, just assigning a value to its reference will create it. - + Sample: Hello World! using variables -

+

- #!/bin/bash + #!/bin/bash STR="Hello World!" - echo $STR + echo $STR -

Line 2 creates +

Line 2 creates a variable called STR and assigns the string "Hello World!" to - it. Then the VALUE of this variable is retrieved by putting - the '$' in at the beginning. Please notice (try it!) + it. Then the VALUE of this variable is retrieved by putting + the '$' in at the beginning. Please notice (try it!) that if you don't use the '$' sign, the output of the program will be different, and probably not what you want it to be. Sample: A very simple backup script (little bit better) -

+

- #!/bin/bash + #!/bin/bash OF=/var/my-backup-$(date +%Y%m%d).tgz tar -cZf $OF /home/me/ -

This script introduces another thing. First - of all, you should be familiarized with the variable +

This script introduces another thing. First + of all, you should be familiarized with the variable creation and assignation on line 2. Notice the expression '$(date +%Y%m%d)'. - If you run the script you'll notice that + If you run the script you'll notice that it runs the - command inside the parenthesis, capturing its output. + command inside the parenthesis, capturing its output.

Notice that in this script, the output filename will be different every day, due to the format switch to the date command(+%Y%m%d). @@ -313,7 +314,7 @@ Variables

Some more examples:

echo ls

echo $(ls) - + Local variables @@ -322,7 +323,7 @@ Variables #!/bin/bash - HELLO=Hello + HELLO=Hello function hello { local HELLO=World echo $HELLO @@ -331,16 +332,16 @@ Variables hello echo $HELLO -

This example should be enought to show how to use a local variable. +

This example should be enought to show how to use a local variable. - + Conditionals - -

Conditionals let you decide whether to perform an action + +

Conditionals let you decide whether to perform an action or not, this decision is taken by evaluating an expression. @@ -348,23 +349,23 @@ Conditionals Dry Theory

Conditionals have many forms. The most basic form is: if then 1' + '2<1' is an expresion that evaluates to false, while '2>1' evaluates to true.xs

Conditionals have other forms such as: - Yet another form of conditionals is: - Yet another form of conditionals is: + A word about syntax:

The base for the 'if' constructions in bash is this: @@ -376,16 +377,16 @@ Conditionals Sample: Basic conditional example if .. then -

+

#!/bin/bash if [ "foo" = "foo" ]; then echo expression evaluated as true fi -

The code to be executed if the expression within braces - is true can - be found after the 'then' word and before 'fi' which indicates the end +

The code to be executed if the expression within braces + is true can + be found after the 'then' word and before 'fi' which indicates the end of the conditionally executed code. @@ -402,7 +403,7 @@ Conditionals Sample: Conditionals with variables -

+

#!/bin/bash T1="foo" @@ -416,8 +417,8 @@ Conditionals + For sample -

+

#!/bin/bash for i in $( ls ); do echo item: $i done -

+

On the second line, we declare i to be the variable that - will take the + will take the different values contained in $( ls ).

The third line could be longer if needed, or there could - be more lines + be more lines before the done (4).

'done' (4) indicates that the code that used the value of $i has finished and $i can take a new value. @@ -481,29 +482,29 @@ Loops for, while and until for i in `seq 1 10`; do echo $i - done + done While sample

- #!/bin/bash + #!/bin/bash COUNTER=0 while [ $COUNTER -lt 10 ]; do echo The counter is $COUNTER - let COUNTER=COUNTER+1 + let COUNTER=COUNTER+1 done

-

This script 'emulates' the well known +

This script 'emulates' the well known (C, Pascal, perl, etc) 'for' structure Until sample

- #!/bin/bash + #!/bin/bash COUNTER=20 until [ $COUNTER -lt 10 ]; do echo COUNTER $COUNTER @@ -516,7 +517,7 @@ Loops for, while and until Functions -

As in almost any programming language, you can use functions to group +

As in almost any programming language, you can use functions to group pieces of code in a more logical way or practice the divine art of recursion.

Declaring a function is just a matter of writing function my_func { my_code }.

Calling a function is just like calling another program, you just write its name. @@ -524,7 +525,7 @@ Functions Functions sample

- #!/bin/bash + #!/bin/bash function quit { exit } @@ -533,33 +534,33 @@ Functions } hello quit - echo foo + echo foo

Lines 2-4 contain the 'quit' function. Lines 5-7 contain the 'hello' function If you are not absolutely sure about what this script does, please try it!.

Notice that a functions don't need to be declared in any specific order. -

When running the script you'll notice that first: the function 'hello' is +

When running the script you'll notice that first: the function 'hello' is called, second the 'quit' function, and the program never reaches line 10. Functions with parameters sample

- #!/bin/bash + #!/bin/bash function quit { exit - } + } function e { - echo $1 - } + echo $1 + } e Hello e World quit - echo foo + echo foo -

This script is almost identically to the previous one. The main difference is the - funcion 'e'. This function, prints the first argument it receives. +

This script is almost identically to the previous one. The main difference is the + funcion 'e'. This function, prints the first argument it receives. Arguments, within funtions, are treated in the same manner as arguments given to the script. @@ -588,20 +589,20 @@ User interfaces echo bad option fi done - -

If you run this script you'll see that it is a - programmer's dream for text based menus. You'll probably notice - that it's very similar to the 'for' construction, only rather + +

If you run this script you'll see that it is a + programmer's dream for text based menus. You'll probably notice + that it's very similar to the 'for' construction, only rather than looping for each 'word' in $OPTIONS, it prompts the user.

- Using the command line + Using the command line

- #!/bin/bash - if [ -z "$1" ]; then + #!/bin/bash + if [ -z "$1" ]; then echo usage: $0 directory exit fi @@ -611,7 +612,7 @@ User interfaces tar -cZf $TGTD$OF $SRCD

-

What this script does should be clear to you. The expression +

What this script does should be clear to you. The expression in the first conditional tests if the program has received an argument ($1) and quits if it didn't, showing the user a little usage message. The rest of the script should be clear at this point. @@ -622,11 +623,11 @@ User interfaces Misc - + Reading user input with read -

In many ocations you may want to prompt the user for some input, and - there are several ways +

In many ocations you may want to prompt the user for some input, and + there are several ways to achive this. This is one of those ways: #!/bin/bash @@ -634,23 +635,23 @@ Misc read NAME echo "Hi $NAME!" -

As a variant, you can get multiple values with read, this example may +

As a variant, you can get multiple values with read, this example may clarify this. #!/bin/bash echo Please, enter your firstname and lastname - read FN LN + read FN LN echo "Hi! $LN, $FN !" - + - + Arithmetic evaluation

On the command line (or a shell) try this:

echo 1 + 1 -

If you expected to see '2' you'll be disappointed. What if +

If you expected to see '2' you'll be disappointed. What if you want BASH to evaluate some numbers you have? The solution is this:

echo $((1+1)) @@ -658,17 +659,17 @@ Misc arithmetic expression. You can achieve this also like this:

echo $[1+1]

-

If you need to use fractions, or more math or you just want it, you +

If you need to use fractions, or more math or you just want it, you can use bc to evaluate arithmetic expressions. -

if i ran "echo $[3/4]" at the command prompt, it would return 0 +

if i ran "echo $[3/4]" at the command prompt, it would return 0 because bash only uses integers when answering. If you ran "echo 3/4|bc -l", it would properly return 0.75. - Finding bash -

From a message from mike (see Thanks to) + Finding bash +

From a message from mike (see Thanks to)

you always use #!/bin/bash .. you might was to give an example of

how to find where bash is located.

'locate bash' is preferred, but not all machines have locate. @@ -685,7 +686,7 @@ Misc

You may try also 'which bash'. - + Getting the return value of a program

In bash, the return value of a program is stored in a special variable called $?. @@ -699,12 +700,12 @@ Misc echo rv: $? - - - + + + - Capturing a commands output -

This little scripts show all tables from all databases (assuming you got MySQL installed). + Capturing a commands output +

This little scripts show all tables from all databases (assuming you got MySQL installed). Also, consider changing the 'mysql' command to use a valid username and password. #!/bin/bash @@ -715,11 +716,11 @@ Misc done - + Multiple source files -

You can use multiple files with the command source. +

You can use multiple files with the command source.

__TO-DO__ @@ -731,25 +732,25 @@ Tables String comparison operators - +

(1) s1 = s2

(2) s1 != s2

(3) s1 < s2

(4) s1 > s2 -

(5) -n s1 -

(6) -z s1 -

+

(5) -n s1 +

(6) -z s1 +

(1) s1 matches s2

(2) s1 does not match s2

(3) __TO-DO__

(4) __TO-DO__

(5) s1 is not null (contains one or more characters) -

(6) s1 is null +

(6) s1 is null String comparison examples -

Comparing two strings. +

Comparing two strings. #!/bin/bash S1='string' @@ -770,7 +771,7 @@ Tables - + Arithmetic operators

+ @@ -780,47 +781,47 @@ Tables

% (remainder) - + Arithmetic relational operators -

-lt (<) +

-lt (<)

-gt (>)

-le (<=)

-ge (>=)

-eq (==)

-ne (!=) -

C programmer's should simple map the operator to its corresponding +

C programmer's should simple map the operator to its corresponding parenthesis. - - + + Useful commands -

This section was re-written by Kees (see thank to...) -

Some of these command's almost contain complete programming languages. - From those commands only the basics will be explained. For a more detailed +

This section was re-written by Kees (see thank to...) +

Some of these command's almost contain complete programming languages. + From those commands only the basics will be explained. For a more detailed description, have a closer look at the man pages of each command. Sed is a non-interactive editor. Instead of altering a file by moving the - cursor on the screen, you use a script of editing instructions to sed, plus the - name of the file to edit. You can also describe sed as a filter. Let's have +

Sed is a non-interactive editor. Instead of altering a file by moving the + cursor on the screen, you use a script of editing instructions to sed, plus the + name of the file to edit. You can also describe sed as a filter. Let's have a look at some examples: $sed 's/to_be_replaced/replaced/g' /tmp/dummy -

Sed replaces the string 'to_be_replaced' with the string 'replaced' and - reads from the /tmp/dummy file. The result will be sent to stdout (normally - the console) but you can also add '> capture' to the end of the line above so +

Sed replaces the string 'to_be_replaced' with the string 'replaced' and + reads from the /tmp/dummy file. The result will be sent to stdout (normally + the console) but you can also add '> capture' to the end of the line above so that sed sends the output to the file 'capture'. $sed 12, 18d /tmp/dummy - +

Sed shows all lines except lines 12 to 18. The original file is not altered by this command. @@ -921,7 +922,7 @@ Tables

More Scripts - Applying a command to all files in a directory. -

+ Applying a command to all files in a directory. +

Sample: A very simple backup script (little bit better)

- #!/bin/bash + #!/bin/bash SRCD="/home/" TGTD="/var/backups/" OF=home-$(date +%Y%m%d).tgz tar -cZf $TGTD$OF $SRCD - +

File re-namer

- + #!/bin/sh # renna: rename multiple files according to several rules # written by felix hudson Jan - 2000 - + #first check for the various 'modes' that this program has #if the first ($1) condition matches then we execute that portion of the #program and then exit - + # check for the prefix condition if [ $1 = p ]; then - + #we now get rid of the mode ($1) variable and prefix ($2) prefix=$2 ; shift ; shift - + # a quick check to see if any files were given # if none then its better not to do anything than rename some non-existent # files!! - + if [$1 = ]; then echo "no files given" exit 0 fi - + # this for loop iterates through all of the files that we gave the program # it does one rename per file given for file in $* do mv ${file} $prefix$file done - + #we now exit the program exit 0 fi - + # check for a suffix rename # the rest of this part is virtually identical to the previous section # please see those notes if [ $1 = s ]; then suffix=$2 ; shift ; shift - + if [$1 = ]; then echo "no files given" exit 0 fi - + for file in $* do mv ${file} $file$suffix done - + exit 0 fi - + # check for the replacement rename if [ $1 = r ]; then - + shift - + # i included this bit as to not damage any files if the user does not specify # anything to be done # just a safety measure - + if [ $# -lt 3 ] ; then echo "usage: renna r [expression] [replacement] files... " exit 0 fi - + # remove other information OLD=$1 ; NEW=$2 ; shift ; shift - + # this for loop iterates through all of the files that we give the program # it does one rename per file given using the program 'sed' # this is a sinple command line program that parses standard input and # replaces a set expression with a give string # here we pass it the file name ( as standard input) and replace the nessesary # text - + for file in $* do new=`echo ${file} | sed s/${OLD}/${NEW}/g` @@ -1056,7 +1057,7 @@ More Scripts done exit 0 fi - + # if we have reached here then nothing proper was passed to the program # so we tell the user how to use it echo "usage;" @@ -1064,9 +1065,9 @@ More Scripts echo " renna s [suffix] files.." echo " renna r [expression] [replacement] files.." exit 0 - + # done! - + @@ -1080,8 +1081,8 @@ More Scripts criteria=$1 re_match=$2 replace=$3 - - for i in $( ls *$criteria* ); + + for i in $( ls *$criteria* ); do src=$i tgt=$(echo $i | sed -e "s/$re_match/$replace/") @@ -1094,7 +1095,7 @@ More Scripts When something goes wrong (debugging) - Ways Calling BASH + Ways Calling BASH

A nice thing to do is to add on the first line #!/bin/bash -x @@ -1105,27 +1106,27 @@ When something goes wrong (debugging) About the document -

Feel free to make suggestions/corrections, or whatever you think +

Feel free to make suggestions/corrections, or whatever you think it would be interesting to see in this document. I'll try to update it as soon as I can. (no) warranty

This documents comes with no warranty of any kind. - and all that + and all that Translations -

Italian: by William Ghelfi (wizzy at tiscalinet.it) +

Italian: by William Ghelfi (wizzy at tiscalinet.it) -

French: by Laurent Martelli +

French: by Laurent Martelli -

Korean: Minseok Park +

Korean: Minseok Park -

Korean: Chun Hye Jin +

Korean: Chun Hye Jin -

Spanish: unknow +

Spanish: unknow -

I guess there are more translations, but I don't have any info of them, +

I guess there are more translations, but I don't have any info of them, if you have it, please, mail it to me so I update this section. @@ -1136,10 +1137,10 @@ About the document Nathan Hurst for sending a lot of corrections. Jon Abbott for sending comments about evaluating arithmetic expressions. Felix Hudson for writing the Kees van den Broek + Kees van den Broek (for sending many corrections, re-writting usefull comands section) Mike (pink) made some suggestions about locating bash and testing files - Fiesh make a nice suggestion for the loops section. + Fiesh make a nice suggestion for the loops section. Lion suggested to mention a common error (./hello.sh: Command not found.) Andreas Beck made several corrections and coments. @@ -1150,11 +1151,11 @@ About the document

Added the section usefull commands re-writen by Kess.

More corrections and suggestions incorporated.

Samples added on string comparison. -

v0.8 droped the versioning, I guess the date is enought. +

v0.8 droped the versioning, I guess the date is enought.

v0.7 More corrections and some old TO-DO sections written.

v0.6 Minor corrections.

v0.5 Added the redirection section. -

v0.4 disapperd from its location due to my ex-boss and thid doc found it's new place +

v0.4 disapperd from its location due to my ex-boss and thid doc found it's new place at the proper url: www.linuxdoc.org.

prior: I don't rememeber and I didn't use rcs nor cvs :( @@ -1165,8 +1166,8 @@ About the document

Introduction to bash (under BE) -

Bourne Shell Programming - http://207.213.123.70/book/ +

Bourne Shell Programming + http://207.213.123.70/book/