summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/gloss
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
commit007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch)
tree90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/gloss
parent950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff)
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/gloss')
-rw-r--r--Master/texmf-dist/doc/latex/gloss/gloss.tex601
-rw-r--r--Master/texmf-dist/doc/latex/gloss/readme30
-rw-r--r--Master/texmf-dist/doc/latex/gloss/sample.tex72
3 files changed, 703 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/gloss/gloss.tex b/Master/texmf-dist/doc/latex/gloss/gloss.tex
new file mode 100644
index 00000000000..18a6ac7c060
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gloss/gloss.tex
@@ -0,0 +1,601 @@
+% +--------------------------------------------------+
+% | Typeset this file to get the documentation. |
+% +--------------------------------------------------+
+%
+% (c) 1998 Jose Luis Diaz, 1999-2002 Jose Luis Diaz and Javier Bezos.
+% All Rights Reserved.
+%
+% This file is part of the gloss distribution release 1.5.2
+% -----------------------------------------------------------
+%
+% This file can be redistributed and/or modified under the terms
+% of the LaTeX Project Public License Distributed from CTAN
+% archives in directory macros/latex/base/lppl.txt; either
+% version 1 of the License, or any later version.
+
+\def\fileversion{1.5.2}
+\def\docdate{July 26, 2002}
+
+\documentclass{ltxguide}
+
+\title{The \textsf{gloss} Package\footnote{The
+\textsf{gloss} package is currently at version \fileversion. \copyright{}
+1998 Jose Luis Diaz,
+1999-2001 Jose Luis Diaz and Javier Bezos. All Rights Reserved.}}
+
+\author{Jose Luis D\'{\i}iaz\\Javier Bezos\footnote{Please, send your
+comments, suggestions and bug reports to \texttt{jbezos@wanadoo.es}.
+New \texttt{.bst} styles are also welcome. English is not my strong
+point, so contact me when you find mistakes in the manual. Other
+packages by Javier Bezos: \textsf{accents, tensind, esindex,
+titlesec, titletoc, dotlessi}.}}
+
+\date{\docdate}
+
+\addtolength{\topmargin}{-3pc}
+\addtolength{\textwidth}{6pc}
+\addtolength{\oddsidemargin}{-2pc}
+\addtolength{\textheight}{7pc}
+
+\raggedright
+\parindent1em
+
+\newcommand{\gloss}{\textsf{gloss}}
+\newcommand{\bibTeX}{\textsc{Bib}\TeX}
+
+\begin{document}
+
+\maketitle
+
+\textsf{Gloss} is a package which allows the creation of glossaries
+using \bibTeX. With this approach, the user writes a database of terms
+and definitions using a file format much like the bibliographic
+databases. Then he inserts in the \LaTeX{} document a command
+|\gloss{<key>}| for selecting which entries he wants to appear in the
+glossary. These keys are written in an auxiliar file when \LaTeX{} is
+run on the document. Then, running \bibTeX{} these entries are
+extracted from the database and collected in alphabetical order in a
+file. The next run of \LaTeX{} read this file and inserts it in the
+appropiate point of the document, typesetting the desired glossary or
+glossaries.
+
+The process is much like the mechanism for including the bibliographic
+references. This approach has several advantages:
+\begin{enumerate}
+\item \bibTeX{} is available in every platform where \TeX{} is.
+\item Glossary entries can be stored in databases, and you needn't
+ rewrite the definitions.
+\item There are a lot of tools for managing \bibTeX{} databases.
+\item \bibTeX{} can sort the entries and group them; furthermore,
+ \bibTeX-8 can sort correctly the entries in non-English
+ languages. (In fact, this is the main raison which the package
+ was first developped for.)
+\item \bibTeX{} is a programable tool and you can define your own
+ styles for acronyms, symbols, and so on, or changing its default
+ behaviour. \textsf{Gloss} styles are pretty simples and creating
+ new ones is not difficult.
+\end{enumerate}
+
+Of course, there also disavantages---for example, you cannot
+select sorting entries word by word or letter by letter, at least
+at present.
+
+The gloss{} bundle includes the \textsf{gloss}.sty package, a
+\textsf{glsplain}.bst style, a \textsf{glsbase}.bib database, and a
+\texttt{sample.tex} file with its \texttt{sample.bib} database
+(and, of course, the \texttt{readme} file and this manual).
+
+\section{The data files}
+
+If you know \bibTeX, you will find this section easy to understand.
+A data file contains a set of records defining terms, and its
+name must have the extension \texttt{.bib}. Every entry has the
+following format:
+\begin{verbatim}
+@gd{gnu,
+ word = {gnu},
+ definition = {Extrange animal}
+}
+\end{verbatim}
+
+Here
+\begin{itemize}
+\item |gnu| is a key identifying the record;
+\item |word| is the word which will be used as headword and in the
+ text; and
+\item |definition| is the definition printed in the glossary.
+\end{itemize}
+
+Here is the description of the available fields, and when they are used
+\begin{description}
+\item[word] Required. It should be given always as it would be
+ written at the middle of a sentence. The basic style
+ \textsf{glsplain} converts its first letter to uppercase for use after
+ a period. In the generated glossary, entries with the
+ same initial are grouped, preceded by a heading with that letter.
+
+\item[definition] Required. The definition can be as long an you
+ want, but you should note that implicit paragraphs (those with a
+ blank line) are ignored and a |\par| would be necessary. The final
+ period should be omitted because it is supplied later (and sometimes it
+ will be replaced by a comma).
+
+\item[short] Optional. A short form. It could be a symbol, an
+ acronym, etc. depending on the nature of the glossary.
+
+\item[sort-word] Optional. If present, this field will be used to
+sort the entries. It is useful in greek symbols and signs, for
+example.
+
+\item[group] Optional. This field should consist in an uppercase
+ letter and is intended for entries not beginning (or not containing)
+ letters. Entries with the same |group| are gathered in the glossary
+ under a single heading and sorted in the whole glossary using this
+ letter, with entries without |group| placed as if they had a group
+ key of |L|. Using both |sort-word| and this field allows grouping,
+ say, greek symbols, numbers, signs and the like under seperate
+ headings. More on that later.
+
+\item[heading] Optional. It forces an entry to be listed under the
+ given heading. Useful in non-English languages when
+ letters with diacriticals are used (even with \bibTeX-8):
+\begin{verbatim}
+@gd{gnu,
+ word = "{\'A}nimo",
+ definition = "...",
+ heading = "A"}
+\end{verbatim}
+This field is uncompatible with |group|.
+
+\end{description}
+
+The |@gd| entry type is the only available currently in |glsplain|.
+|@glossdef| is a synonymous.
+
+The default |crossref| field is available, but in glossaries is mostly
+unpractical except in a few cases (for example, in a list of symbols
+with the same greek letter with many meanings).
+
+\section{Basic commands}
+
+\begin{decl}
+|\makegloss|
+\end{decl}
+
+This command in the preamble tells \gloss{} to create a glossary.
+
+\begin{decl}
+|\gloss{<key>}|
+\end{decl}
+
+Similar to |\cite|. It writes a ``citation'' to the auxiliary file
+|.gls.aux|. Sadly, this double extension is necessary because
+\bibTeX{} requires the input file to be named with the |.aux|
+extension. Below is explained how MS-DOS users can work around that.
+Note that this file is not reread by the document, it just
+provides information to \bibTeX\ of terms cited.
+
+\begin{decl}
+|\printgloss{<databases>}|
+\end{decl}
+
+Similar to |\bibliography|. It prints the glossary stored into the
+|.gls.bbl| file generated by \bibTeX{} from |.gls.aux|.
+
+In this basic interface the \textsf{glsplain} style is used always.
+
+\section{The generated glossary}
+
+The steps to generate and use the glossary are:
+\begin{itemize}
+\item \LaTeX{} the document (let's call it |file.tex|),
+\item \bibTeX\ the |.gls.aux| file (i.e., |bibtex file.gls|),
+\item \LaTeX{} the document again, and
+\item \LaTeX{} again if there are unresolved cross references.
+\end{itemize}
+
+Once \LaTeX{}ed the document, and \bibTeX{}ed the |.gls.aux| file,
+you will get the glossary in the |.gls.bbl| with the following \TeX{}
+format:
+\begin{itemize}
+
+\item the whole glossary is enclosed in the |thegloss| environment,
+ which just prints the sectioning heading whith the |\glossname| title;
+
+\item a series of |\glossheading|s (or |\glossgroup|s) commands
+ and |glossitem|s environments. Note that gloss items are not
+ commands but environments. The |glossitem*| environment means that
+ the definition of the entry ends with a period.
+
+\end{itemize}
+
+\section{The whole thing}
+
+Most of the formatting is done by the package and not by \bibTeX. The
+\textsf{glsplain} style provides two forms, sometimes three, of
+terms: the basic form as given in |word| to be used in the text,
+and probably as headword, the second one is |word| with the first
+letter uppercased to be used at the beginning of a sentence; and only
+if |short| was included, a short form.
+
+Not surprisingly, the syntax of the \gloss{} commands is very
+alike to that of bibliographies with some touches from that
+of indexes.
+
+\subsection{Package options}
+
+\begin{decl}
+|refpages|
+\end{decl}
+
+The number of the first page where the term is referred to, is
+appended to the gloss entry.
+
+\subsection{Multiple glossaries}
+
+\begin{decl}
+|\makegloss|\\
+|\newgloss{<name>}{<suffix>}{<title>}{<style>}|
+\end{decl}
+
+For defining a new glossary use |\newgloss|. The |\makegloss|
+command is just a synonymous with
+\begin{verbatim}
+\newgloss{default}{.gls}{\glossname}{glsplain}
+\end{verbatim}
+Note that the suffix does include the dot.
+
+MS-DOS users must use |\newgloss| instead of |\makegloss|, and
+a document name with at most seven letters. For instance:
+\begin{verbatim}
+\newgloss{default}{G}{\glossname}{glsplain}
+\end{verbatim}
+Note that, in this case, the suffix does not include the dot
+(this way we avoid double extensions).
+
+\begin{decl}
+|\printgloss[<name>]{<databases>}|
+\end{decl}
+
+Prints the |<name>| glossary. By default, the |default| one
+is printed.
+
+\subsection{The \texttt{\string\gloss} command}
+
+\begin{decl}
+|\gloss[<options>]{<key>}|
+\end{decl}
+
+Possible options are:
+\begin{itemize}
+\item |nocite| makes the command behave in the same fashion
+ as |\nocite|. For example, with |\gloss[nocite]{*}| all entries of
+ the databases are included in the glossary.\footnote{The command
+ |\string\onlygloss| is a deprecated synonymous with
+ |\string\gloss[nocite]|.}
+
+\item |refpage| tells \gloss{} to ignore previous references to pages.
+ Sometimes you say things like ``...at the end of the chapter, we will
+ introduce the concept of...''; when the concept is actually
+ introduced you should use this option.
+
+\item |<name>| of the glossary file where the key is written,
+ as defined by |\newgloss|. The key will be written into that
+ glossary. If there is no |<name>| it defaults to |default|.
+\end{itemize}
+
+The following options control the format of the term in the text.
+
+\begin{itemize}
+
+\item |word| prints the term exactly as given in the |word| field.
+
+\item |Word| prints the term as given in the |word| field, but
+ with the first letter uppercased.\footnote{%
+ The command |\string\Gloss| is a deprecated synonymous with
+ |\string\gloss[Word]|.}
+
+\begin{verbatim}
+ ...discovered. \gloss[Word]{spectroscopy} became one of the most...
+\end{verbatim}
+
+\item |short| prints the short form, provided the bib file defines it
+ (if not a warning is reported).
+
+\item |Long| prints a combination of |Word| and |short|: ``Word
+ (short)''.
+
+\item |long| prints a combination of |word| and |short|: ``word
+(short)''. For example, the very first time an acronym is used:
+\begin{verbatim}
+...and the proposals made by the \gloss[long]{iupac} provide...
+\end{verbatim}
+ Of course, you may want the following references to be in the short
+ form; just define
+\begin{verbatim}
+\newcommand{\acronym}[2][]{\gloss[short,#1]{#2}}
+\end{verbatim}
+
+\end{itemize} The former (|nocite| and |refpage|) are built in,
+|<name>|s are created by |\newgloss|, and the latter are created by
+the package with |\setglosstext|; if no option defined by
+|\setglosstext| is included, it defaults to |word|.
+
+\begin{decl}
+|\setglosstext{<option-name>}{<format>}| \quad (3 parameters)\\
+|\ifglossshort{<format>}| \qquad |\ifglossshort*{<format>}|
+\end{decl}
+
+|\setglosstext| sets how entries are printed in the main text by
+|\gloss|, where |<option-name>| is the name to be used in the optional
+argument of |\gloss|. There are five predefined formats, described
+above, which you may redefine or complement with new defined ones. In
+|<format>| there are three available arguments, which are defined
+implicitly:
+|#1| is |word|, |#2| is |word| with its initial uppercased, and |#3|
+is the |short| field. Thus, the package does the following:
+\begin{verbatim}
+\setglosstext{word}{#1}
+\setglosstext{Word}{#2}
+\setglosstext{short}{\ifglossshort*{#3}{}}
+\setglosstext{long}{#1\ifglossshort*{ (#3)}{}}
+\setglosstext{Long}{#2\ifglossshort*{ (#3)}{}}
+\end{verbatim}
+Use is made of |\ifglossshort| which takes the first argument if the
+short form exists, and the second one if does not exist. In the
+latter case, that is done silently in the unstarred version, but with
+an error in the starred one.
+
+\subsection{Glossary layout}
+
+\begin{decl}
+|\glossheading{<format>}|
+\end{decl}
+
+Sets how the headings are formatted; it is redefined with
+|\renewcommand|. For example:
+\begin{verbatim}
+\renewcommand\glossheading[1]{%
+ \stopglosslist
+ \subsection*{#1}}
+\end{verbatim}
+
+\begin{decl}
+|\setglossgroup{<group>}{<heading>}|
+\end{decl}
+
+Sets the heading corresponding to entries grouped by \textsf{glsplain}
+under the same |group| key (and preceded by |\glossgroup|, which in
+turn calls |\glossheading|).
+\begin{verbatim}
+\setglossgroup{C}{Signs}
+\end{verbatim}
+
+\begin{decl}
+|\setglosslabel{<format>}| \quad (3 parameters)
+\end{decl}
+
+Sets which of the three forms are printed as label in the gloss items and
+some other optional formatting.
+
+The package does:
+\begin{verbatim}
+\setglosslabel{\sffamily\bfseries#1\ifglossshort{ (#3)}{}}
+\end{verbatim}
+
+\begin{decl}
+|thegloss|
+\end{decl}
+
+By default, the main environment just prints the gloss title.
+You may change its definition.
+
+\begin{decl}
+|glosslist|\\
+|\stopglosslist|
+\end{decl}
+
+You usually won't see the |glosslist| environnment. It is automatically
+started by |glossitem| if necessary. You may stop it with the
+|\stopglosslist|. That's so done to interact with the format
+of the heading for each letter group. The above example of
+|\glossheading| uses it because sectioning commands cannot be
+used inside lists; this way, the list is stopped, the title is
+printed, and the following |glossitem| restarts the list. If
+you say:
+\begin{verbatim}
+\renewcommand{\glossheading}[1]{}
+\end{verbatim}
+the whole glossary is printed in a single list (with no unwanted
+space between letter groups).
+
+\textsf{Gloss} provides its own format for |glosslist|
+(simply because the authors like it) with a |\glosshang| length
+to adjust the left margin, but you may change its definition.
+
+\begin{decl}
+|glossitem|\\
+|glossitem*|
+\end{decl}
+
+Its |\begin| consists of an |\item| and some additional stuff. Its
+|\end| adds a period (except in the starred version) or the page
+number. You should not modify this environment, except if you want a
+format not based in a list environment.
+
+Here is an example of how to modify the layout of the glossary:
+\begin{verbatim}
+\setglosslabel{#2}
+
+\renewcommand{\glossheading}[1]{%
+ \stopglosslist % -- Don't forget that!
+ \vspace{1pc}%
+ {\large\centering\bfseries#1\par}}
+
+\renewenvironment{glosslist}
+ {\begin{description}}
+ {\end{description}}
+\end{verbatim}
+
+\begin{decl}
+|\glosspage|\\
+|\xglosspage|
+\end{decl}
+
+This command is used to print the page at the end of the gloss entry
+with |refpages|. If the entry ends with a period, |\xglosspage| is
+used, which by default just maps to |\glosspage|. You may redefine them
+with |\renewcommand|:
+
+\begin{verbatim}
+\renewcommand{\glosspage}[1]{. (See page~#1)}
+\renewcommand{\xglosspage}[1]{ (See page~#1)}
+\end{verbatim}
+
+
+\section{Order of items}
+
+Now we explain how \bibTeX{} sorts and groups entries. Firstly, the
+necessary values are assigned, if necessary. The |group| field is
+used, as stated above, for entries consisting of non alphabetical
+terms, and differents steps are followed depending on whether
+this field exists or not.
+
+If |group| is not present, then
+\begin{itemize}
+\item |sort-word|, if omitted, is |word| lowercased with
+ non alphabetical signs removed.
+
+\item |heading|, if omitted, is the first letter in
+ |word|.
+\end{itemize}
+If |group| is present, then
+\begin{itemize}
+\item |sort-word|, if omitted, is |word| lowercased with
+ non alphabetical signs \textit{not} removed.
+
+\item |heading| is not used.
+\end{itemize}
+
+Now, entries can be sorted. First, they are ordered by |group|, and
+then, inside each group, by |sort-word|. In fields with |group| and
+no |sort-word| the ASCII codes are used. No further sortening is
+done. Finally, entries are grouped: first, consecutive entries with
+the same |group| field; then, consecutive entries whose |group| is "L"
+and with the same |heading| field. Note that |group| sorts and
+groups, |sort-word| just sorts, and |heading| just groups.
+
+Now, let's answer the following simple question: When should I use
+|heading| and |sort-word|? If the word begins with a letter with
+diacritical mark alphabetized under the letter without diacritical
+mark (a fairly frequent case), use heading, does not matter you are
+using \bibTeX{} or \bibTeX 8:
+\begin{verbatim}
+@gd{ecole,
+ word = "{\'e}cole",
+ definition = "...",
+ heading = "E"
+}
+\end{verbatim}
+(\texttt{\'ecole} and \texttt{{'e}cole} are allowed, too).
+
+If the word begins with a letter which is placed under a heading of
+its own, use |sort-word| in \bibTeX{} and nothing in \bibTeX8
+(provided a correct sorting file is provided, which is not the case
+for many languages):
+\begin{verbatim}
+@gd{nname,
+ word = "{\~n}ame",
+ definition = "...",
+ sort-word = "nzzame"
+}
+\end{verbatim}
+in 7-bits versions. In 8-bits version, you may set |word| as
+\texttt{\~name} and suppress the |sort-word| field.
+
+Anyway, if you are using a 7-bits version you may want using both fields:
+\begin{verbatim}
+@gd{innigo,
+ word = "{\'I}\~nigo",
+ definition = "...",
+ heading = "I",
+ sort-word = "Inzzigo"
+}
+\end{verbatim}
+
+Finaly, \textsf{gloss} provides inside the |thegloss| environment the
+|\+zz+| command expanding to nothing, where |zz| is any text helping
+in sorting entries (usualy |zz|); this way, |sort-field| is not
+necessary in most of cases:
+\begin{verbatim}
+@gd{nname,
+ word = "{\~n\+zz+}ame",
+ definition = "..."
+}
+\end{verbatim}
+An example in Swedish is |\+zzx+\r{a}|, in Czech
+|{\v{c}\+zz+}|, and in Breton (8-bits) |\+n+\~n|. (Of course,
+\bibTeX{} could translate from a readable form to one for
+alphabetizing. That should be done in a future.) Using either
+|sort-word| or |\+zz+| is a question of personal taste; One of us [JB]
+uses |sort-word| while the other [JLDA] prefers
+\bibTeX8. This syntax is not compliant with the \LaTeX\ interface
+guidelines (use braces or brackets always) but it's short, which was
+the main goal; this feature is mostly unsuportted, however.
+
+\section{Complements}
+
+\subsection{The \textsf{glsbase} database}
+
+This database defines some useful strings which can be used
+in other databases. Currently, it only includes a set of
+strings named |alphasort|, |betasort|, etc. to be used
+in the |sort-word| field to provide the right order of
+greek symbols. (They are defined as |"01"| , |"02"|, etc.)
+
+\subsection{The \textsf{glsshort} style}
+
+This style is provided for acronym lists. It sorts and creates
+headings using the |short| filed. A new |sort-short| can be used
+to fine tune the order of entries (this field will be ignored
+in the \textsf{glsplain} style). However, note that the
+printed form still follows the conventions given above, and
+you should use the |short| specifier in |\cite|, and
+|\setglosslabel|.
+
+\subsection{Compatibility with \textsf{hyperref}}
+
+If the \textsf{hyperref} package is loaded, links from the
+word to the entry will be created. You can control
+the appearance of gloss links with the following macros:
+|\glosslinkborder|, |\glosslinkcolor|,
+|\glosslinkbordercolor| (which correspond to |pdfborder|,
+|linkcolor| and |linkbordercolor|); you can change
+them with |\renewcommand|.
+
+\subsection{The sample file}
+
+Once installed \gloss{} you should be able to typeset the
+|sample.tex| file, which will enlighten the usage
+of this package --- \LaTeX{} to write the auxiliary file, \bibTeX{}
+to create the glossary, \LaTeX{} to define the labels, and \LaTeX{}
+to see the final result. Disclaimer: its text is in Spanish.
+
+\subsection{Backward uncompatibility}
+
+Version 0.1 beta had a different syntax for the |\gloss|
+command. The old syntax |\gloss[<word>]{<key>}| does not work
+and |<word>\gloss[nocite]{<key>}| should be used instead. The
+|\glossstyle| command has been removed and its functionality
+merged into |\newgloss|.
+
+\subsection{Language support}
+
+The following package options provide translation of the glossary
+heading and page abbreviation: |basque|, |catalan|, |danish|, |dutch|,
+|french|, |german|, |italian|, |portuguese| (and |brazilian|),
+|russian| (any encoding), |polish|, |spanish| and |swedish|.
+Translations to other languages are welcome.
+
+\end{document}
+
diff --git a/Master/texmf-dist/doc/latex/gloss/readme b/Master/texmf-dist/doc/latex/gloss/readme
new file mode 100644
index 00000000000..b03b102e616
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gloss/readme
@@ -0,0 +1,30 @@
+Gloss 1.5.2
+~~~~~~~~~~~
+
+Gloss is a package which allows the creation of glossaries
+using bibTeX. This approach has several advantages:
+- bibTeX is available in every platform where TeX is.
+- Glossary entries can be stored in databases, and you needn't
+ rewrite the definitions.
+- There are a lot of tools for managing bibTeX databases.
+- bibTeX is a programable tool and you can define your own
+ styles for acronyms, symbols, and so on.
+
+The file gloss.tex contains the documentation.
+
+Release 1.5.1 fixes a few bugs:
+
+- page was missing when a nocite form was followed by a
+ "normal" form (not a frequent situation, however).
+- chars usually allowed in \cite now are allowed in \gloss
+ as well
+- refpage was no-op with nocite. Now it can be used to
+ refer to the page even if the term in not cited in the
+ text (and since this combination did not make sense
+ formerly, I hope there won't be uncompatibilities).
+
+Release 1.5.2 fixes a bug:
+
+- Sometimes the space following \gloss was gobbled.
+
+2002/07/26
diff --git a/Master/texmf-dist/doc/latex/gloss/sample.tex b/Master/texmf-dist/doc/latex/gloss/sample.tex
new file mode 100644
index 00000000000..2c181ec55ae
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/gloss/sample.tex
@@ -0,0 +1,72 @@
+% (c) 1998 Jose Luis Diaz, 1999-2002 Jose Luis Diaz and Javier Bezos.
+% All Rights Reserved.
+%
+% This file is part of the gloss distribution release 1.5.2
+% -----------------------------------------------------------
+%
+% This file can be redistributed and/or modified under the terms
+% of the LaTeX Project Public License Distributed from CTAN
+% archives in directory macros/latex/base/lppl.txt; either
+% version 1 of the License, or any later version.
+%
+
+\documentclass[a4paper,spanish]{article}
+% \usepackage[latin1]{inputenc}
+
+\usepackage[refpages]{gloss}
+
+% Try that, if you want:
+%
+% \usepackage[colorlinks,dvips]{hyperref}
+% \renewcommand{\glosslinkborder}{0 0 0}
+% \renewcommand{\glosslinkcolor}{blue}
+
+\makegloss
+
+\setglossgroup{C}{Signos}
+\setglossgroup{S}{S\'{\i}mbolos}
+
+\title{Ejemplo de uso del paquete \textsf{Gloss}}
+\author{Jose Luis D\'{\i}az}
+
+\begin{document}
+\maketitle
+\begin{abstract}
+ Este documento pretende tan s\'olo servir de muestra de c\'omo se usa el
+ paquete \textsf{gloss} para la creaci\'on de glosarios. Los t\'erminos
+ incluidos en este glosario se han elegido porque plantean problemas
+ de ordenaci\'on alfab\'etica.
+\end{abstract}
+
+\section{Ejemplo}
+
+El c\'odigo \gloss[short]{ASCII} no previ\'o la \gloss[nocite]{ene}
+necesidad de vocales acentuadas ni de otros caracteres no
+anglosajones. Por suerte, este c\'odigo s\'olo usa 7
+bits\gloss[nocite]{bit}, por lo que usando el \gloss{bit} que deja
+libre se dispone de 128 caracteres m\'as, donde acomodar los
+s\'{\i}mbolos no previstos.
+
+No obstante, esto plantea problemas a los programas de
+alfabetizaci\'on, que no pueden basarse ya en el sencillo m\'etodo de
+comparar los c\'odigos de los caracteres para determinar cu\'al va
+antes alfab\'eticamente. En efecto, la ``\gloss{egne}'' tendr\'{\i}a
+un c\'odigo superior a 128, lo cual la situar\'{\i}a alfab\'eticamente
+por encima de la ``\gloss{zeta}'', cuando en realidad deber\'{\i}a ir
+despu\'es de la ``\gloss{ene}''.
+
+Bib\TeX\ admite caracteres de 8 bits como parte de los nombres de los
+autores, pero realiza una ordenaci\'on incorrecta de los mismos, ya
+que se basa simplemente en la comparaci\'on num\'erica de los
+c\'odigos de los caracteres.
+
+\gloss[Word]{bibtex8} es una implementaci\'on que permite especificar
+al usuario qu\'e orden alfab\'etico ocupa cada caracter dentro de un
+juego de caracteres de 8 bits\gloss[nocite]{bit}.
+\gloss[nocite]{gnu,a,pi,alfa,exclam,interr,nuname}
+
+\sloppy
+
+\printgloss{glsbase,sample}
+
+\end{document} \ No newline at end of file