new latex package combelow (19oct09)

git-svn-id: svn://tug.org/texlive/trunk@16213 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 206 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/combelow/README b/Master/texmf-dist/doc/latex/combelow/README
new file mode 100644
index 00000000000..5ed643ad9c4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/combelow/README
@@ -0,0 +1,26 @@
+This is the README file for combelow package.
+
+combelow: comma below (accent)
+
+combelow provides you with a command that typesets comma belowed characters.
+
+Author:
+-------
+Gianluca Pignalberi (g.pignalberi@freesoftwaremagazine.com)
+
+Copyright: 2009 by Gianluca Pignalberi
+----------
+This program 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.
+
+Installation:
+-------------
+Copy combelow.sty in a suitable directory under texmf/tex/latex, and 
+combelow.pdf and this README in the corresponding directory under 
+texmf/doc/latex, then run texhash (check your system to locate the texmf tree).
+
+Usage:
+------
+To add a comma below (accent) to a character, call it x, just write \cb x in 
+your document.
diff --git a/Master/texmf-dist/doc/latex/combelow/combelow.bib b/Master/texmf-dist/doc/latex/combelow/combelow.bib
new file mode 100644
index 00000000000..b397c63ed19
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/combelow/combelow.bib
@@ -0,0 +1,30 @@
+@article{babel,
+	title = "{Babel, a multilingual package for use with \LaTeX's standard 
+		document classes}",
+	author = "Johannes Braams",
+	year = "2006",
+	note = "{\url{http://www.ctan.org}}",
+}
+
+@misc{Ced,
+        author = "Wikipedia",
+        title = "{Cedilla}",
+        note = "{\url{http://en.wikipedia.org/wiki/Cedilla}}",
+        year = "2009",
+}
+
+@misc{Unitables,
+        author = "{Unicode Consortium}",
+        title = "{Code charts}",
+        note = "{\url{http://www.unicode.org/charts}}",
+        year = "2009",
+}
+
+@article{GP09,
+	author = "Gianluca Pignalberi",
+	title = "{\textsf{combelow}: abbasso i segni diacritici di serie B}",
+	journal = "ArsTeXnica",
+	number = "8",
+	year = "2009",
+	month = "October",
+}
diff --git a/Master/texmf-dist/doc/latex/combelow/combelow.pdf b/Master/texmf-dist/doc/latex/combelow/combelow.pdf
new file mode 100644
index 00000000000..0944a73884f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/combelow/combelow.pdf
diff --git a/Master/texmf-dist/doc/latex/combelow/combelow.tex b/Master/texmf-dist/doc/latex/combelow/combelow.tex
new file mode 100644
index 00000000000..c4601283fcc
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/combelow/combelow.tex
@@ -0,0 +1,150 @@
+\documentclass{ltxdoc}
+
+\usepackage{combelow}
+\usepackage{url}
+\usepackage{listings}
+\lstset{numbers=left,numberstyle=\tiny,basicstyle=\ttfamily,language=[LaTeX]TeX,breaklines}
+
+\begin{document}
+\title{The \textsf{combelow} package}
+\author{Gianluca Pignalberi\\\texttt{g.pignalberi@freesoftwaremagazine.com}}
+\date{10/11/2009~(0.99e)}
+\maketitle
+
+\begin{abstract}
+Standard \LaTeX{} doesn't have the commands necessary to typeset some
+``secondary'' diacritic marks used in some European languages. Romanian and 
+Latvian have some letters with a \emph{comma below} (aka comma accent). Up 
+to now, \LaTeX{} users approximated it with the \emph{cedilla} (~\c{}~). From
+now on they have a proper comma below (~\cb{}~).
+\end{abstract}
+
+\section{Introduction}
+Once I had to typeset a flyer in Romanian. The flyer text had a word 
+containing a `\cb t'. To my big surprise and disappointment, \LaTeX{} 
+wasn't able to produce that glyph with a specific command, and I then 
+approximated it with a cedilla (after reading chapter 40 of \cite{babel}).
+After asking some Romanians, they told me the flyer was ok, but those answers
+didn't persuade me: every Romanian newspapers and magazines had a comma below
+Ts and Ss, not a cedilla.
+
+I decided to read Unicode books and documents~\cite{Unitables,Ced}, and 
+discovered that \c s and \c t are Turkish strokes. Romanian would rather have
+the so-called \emph{comma below} (a preferred form for cedilla). I also 
+discovered that Latvian has some other letters with a comma below: g, k, l, n
+and r. Being `g' a descending letter, its comma below becomes a 
+\emph{turned comma above} (\cb g).
+
+I thought that using \textsf{utf8x} encoding would allow me to typeset those 
+letters, and their corresponding uppercase versions, once typed with a 
+Unicode editor. I was wrong, and a real command was needed.
+
+You can find a more in-depth description of the whole work in~\cite{GP09}.
+
+\section{Usage}
+After including the package into your document 
+(\verb+\usepackage{combelow}+), you're provided with the command \verb+\cb+
+that typesets its argument with the proper comma. Table~\ref{tab:cb}
+summarizes commands and results.
+
+\begin{table}
+\centering
+\begin{tabular}{cc}
+Command&Result\\
+\verb+\cb g+&\cb g\\
+\verb+\cb k+&\cb k\\
+\verb+\cb l+&\cb l\\
+\verb+\cb n+&\cb n\\
+\verb+\cb r+&\cb r\\
+\verb+\cb s+&\cb s\\
+\verb+\cb t+&\cb t\\
+\end{tabular}
+\caption{Examples of comma below-ed letters}
+\label{tab:cb}
+\end{table}
+
+\section{Properties and known issues}
+A lot of Romanian printed matter show comma below-ed letters with a comma
+below slightly smaller than the actual font size. The package isn't able yet
+to manage a comma below less than the current font size.
+
+If you want to put the comma accent below a two or more bytes Unicode 
+character, you have to surround it with braces, just as you would do with 
+other standard accents.
+
+The biggest drawback is that the package doesn't allow hyphenation and loses
+kerning information too.
+
+\section{The code}
+\begin{lstlisting}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{combelow}[2009/11/10 v0.99e comma below command]
+\def\@commafont{\check@mathfonts
+    \fontsize\sf@size\z@\selectfont}
+\DeclareRobustCommand{\cb}[1]{{%
+\setbox\z@\hbox{#1}%
+\ifdim\dp\z@<.1\ht\z@\ooalign{\unhbox\z@\crcr\hidewidth\lower.4ex\hbox{\@commafont,}\hidewidth}%
+\else\ooalign{\unhbox\z@\crcr\hidewidth\raise.5ex\hbox{\@commafont`}\hidewidth}%
+\fi}}%
+\endinput
+\end{lstlisting}
+That's all: it stacks a comma (typeset in a smaller font) under a character 
+without descendant (with no depth), while stacks an open single quote over a 
+descending character (with a significant depth, since some Times fonts have no
+descendant, while being deeper than 0).
+
+\bibliographystyle{plain}
+\bibliography{combelow}
+
+\appendix
+\section{Changes}
+\textbf{2009/04/21} \textbf{v0.1} 
+
+\vspace{.5em}
+\noindent
+\begin{itemize}
+\item Initial version, not released. Could only typeset g, k, l, n, r, s 
+and t with comma below, and the corresponding uppercase letters.
+\end{itemize}
+
+\vspace{.5em}
+\noindent
+\textbf{2009/04/30} \textbf{v0.2}
+
+\vspace{.5em}
+\noindent
+\begin{itemize}
+\item Not released. Could typeset every not descending letters with comma 
+below, but only g among descending letters.
+\end{itemize}
+
+\vspace{.5em}
+\noindent
+\textbf{2009/08/23} \textbf{v0.99a, b, c, d}
+
+\vspace{.5em}
+\noindent
+\begin{itemize}
+\item Can typeset all letters with comma below, recognizing descendents and
+positioning the comma according to them (wrong turned comma above for italics 
+and slanted characters in 0.99a; wrong vertical position in 0.99c). Since all 
+of these versions are contemporary, I've just released 0.99d.
+\end{itemize}
+
+\vspace{.5em}
+\noindent
+\textbf{2009/10/19} \textbf{v0.99d bug fix}
+
+\begin{itemize}
+\item Fixed a problem with fonts like Times. Thanks to Enrico Gregorio.
+\end{itemize}
+
+\vspace{.5em}
+\noindent
+\textbf{2009/11/10} \textbf{v0.99e}
+
+\begin{itemize}
+\item Now the comma is finally smaller than the current font. Thanks to Enrico 
+Gregorio for providing me with the necessary code.
+\end{itemize}
+\end{document}