diff options
author | Karl Berry <karl@freefriends.org> | 2008-10-10 23:16:41 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2008-10-10 23:16:41 +0000 |
commit | 5045cf0ceaea0306461134c8e404a9c11833f9c7 (patch) | |
tree | 0cf0e658bca2702897bc71870ea38378cc076210 /Master/texmf-dist/doc/latex/bullcntr/bullcntr-man.tex | |
parent | 7016e88015cc3833195504ac8138ee789fd0b100 (diff) |
bullcntr update (8oct08)
git-svn-id: svn://tug.org/texlive/trunk@10918 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bullcntr/bullcntr-man.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/bullcntr/bullcntr-man.tex | 56 |
1 files changed, 30 insertions, 26 deletions
diff --git a/Master/texmf-dist/doc/latex/bullcntr/bullcntr-man.tex b/Master/texmf-dist/doc/latex/bullcntr/bullcntr-man.tex index 8528e46908e..c4559a3e0b4 100644 --- a/Master/texmf-dist/doc/latex/bullcntr/bullcntr-man.tex +++ b/Master/texmf-dist/doc/latex/bullcntr/bullcntr-man.tex @@ -34,11 +34,11 @@ (see page~\pageref{S:Copyright} for details).}} \author{G.~Mezzetti\\{\ttfamily\normalsize gustavo.mezzetti@istruzione.it}} -\date{October~1, 2007} +\date{October~10, 2008} \newcommand*{\bullvers}{0.04} \newcommand*{\bulldate}{2007/04/02} -\newcommand*{\filename}{bullcntr-man.dtx} +\newcommand*{\filename}{bullcntr-man.tex} \DeclareRobustCommand*{\command}[1]{% {\texorpdfstring{\normalfont\ttfamily \char\escapechar}{\pdfbslash}#1}% @@ -124,8 +124,8 @@ are reserved, except as noted below. This document has been produced by feeding to a \LaTeX\ typesetting engine the file \filedir{\filename}. This file is part of a work -named ``\bull\ package'', and may distributed and/or modified only as -a part thereof. Subsection~\ref{SS:License} on +named ``\bull\ package'', and may be distributed and/or modified only +as a part thereof. Subsection~\ref{SS:License} on page~\pageref{SS:License} explains the conditions under which \tbull\ may be distributed and/or modified. @@ -134,10 +134,11 @@ means (\emph{e.g.}, photocopying, direct printing from the electronic version, and so on). Note, though, that distribution of this document alone is -``distribution of only part of the Work'' in the sense of the \LaTeX\ -Project Public License, and should be avoided: please distribute, in -addition, the source file \filedir{\filename} together with all other -files listed in \filedir{manifest.txt}, as explained as well in +``distribution of only part of the Work'' in the sense of the +\href{http://www.latex-project.org/lppl.txt}{\LaTeX\ Project Public +License}, and should be avoided: please distribute, in addition, the +source file \filedir{\filename} together with all other files listed +in \filedir{manifest.txt}, as explained as well in Subsection~\ref{SS:License} and in the file \filedir{manifest.txt} itself. @@ -151,19 +152,19 @@ itself. \section{Introduction} \label{S:Intro} -I can't remember exactly where the idea of this package arose from, -but I am pretty sure that the first time I saw a list of items +I~can't remember exactly where the idea of this package arose from, +but I~am pretty sure that the first time I~saw a list of items numbered with an increasing number of bullets was in certain handwritten notes about sheaves cohomology, may be a decade or so ago. -Since then, I had repeatedly thought of writing a \LaTeX\ package to -implement this kind of numbering, but I had never resolved to actually -do so, until very recently, when I suddenly decided to sit down and +Since then, I~had repeatedly thought of writing a \LaTeX\ package to +implement this kind of numbering, but I~had never resolved to actually +do so, until very recently, when I~suddenly decided to sit down and % ( paren match write the code!~:-) -Regrettably, I had to discover a major bug in the macros I had dashed +Regrettably, I~had to discover a major bug in the macros I~had dashed off in such a haste, which required extensive (and more careful!)\ -redesign of the code. I took this opportunity to thoroughly +redesign of the code. I~took this opportunity to thoroughly reorganize the package, making it easier, for the user, to switch from one style of bullets to another, and also adding an ancillary package that simplifies the creation of lists numbered with bullets. @@ -203,7 +204,7 @@ should tell you how to find the \LaTeX\ input directory/ies, and probably also how to create new \LaTeX\ input directories reserved to contain your private classes and packages. If your \TeX\ installation offers you the chance of defining your private \LaTeX\ input -directories, I recommend you exploit this possibility and place the +directories, I~recommend you exploit this possibility and place the generated files into such a directory. Please note that before using \tbull\ you must read the license (see @@ -256,7 +257,7 @@ The \bull\ package has the LPPL maintenance status ``author-maintained''. % Switching to the ``maintained'' status (which % is the status recommended by the \TeX\ community) is currently being -% considered, but for now I still prefer to keep my tiny unfledged +% considered, but for now I~still prefer to keep my tiny unfledged % % ( paren match % creation under my protecting wing\ldots~:-)\spacefactor=\sfcode`. % \space Leaving jokes apart, I'm waiting to see if other ``disastrous'' @@ -274,12 +275,15 @@ Public License, are to be interpreted in the case of this work. \subsubsection{Use} The use of \tbull\ is unrestricted, provided that you accept the terms -and conditions of the \LaTeX\ Project Public License and of the -following subsection for what concerns the absence of any warranty. +and conditions of the +\href{http://www.latex-project.org/lppl.txt}{\LaTeX\ Project Public +License} and of the \hyref{SSS:NoWarranty}{following subsection} for +what concerns the absence of any warranty. \subsubsection{No warranty} +\label{SSS:NoWarranty} There is absolutely no warranty for \tbull. The Copyright Holder provides \tbull\ ``as is'', without warranty of any kind, either @@ -434,7 +438,7 @@ definition is already set by \tbull\ itself. When, on the other hand, the value of the counter being displayed is greater than or equal to~6 (6~or more bullets need to be drawn), the \verb|\bullcntr| command calls the \verb|\countersmallbullet| macro. -It is intended that this macro typesets a character suitable for +It is intended that this macro typeset a character suitable for situations in which the ``bullets'' have to be grouped in a compact cluster; typically, this means that a smaller ``bullet'' is used than the one typeset by \verb|\counterlargebullet|, although it is @@ -1286,12 +1290,12 @@ Now the bad news: you might want to refer to, say, item reference comes out wrong, since the label from the outer enumeration % ( paren match is typeset with the style of the inner one.~:-(\spacefactor=\sfcode`. -\space This is a known bug: I\@ decided not to correct it, since doing -so would require introducing the concept of bullet styles -distinguished by level, which I\@ deem intolerably burdensome. Be -aware of this limitation when you nest \beenv\ environments inside one -another (this does not apply, however, to \beenv's nested within -\enenv's, as we'll see in the following examples). +\space This is a known bug: I~chose not to correct it, since doing so +would require to introduce the concept of bullet styles distinguished +by level, which I~deem intolerably burdensome. Be aware of this +limitation when you nest \beenv\ environments inside one another (this +does not apply, however, to \beenv's nested within \enenv's, as we'll +see in the following examples). |