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} - -