
\documentclass[a4paper,12pt]{article}
\usepackage[english]{babel}
\usepackage[latin1]{inputenc}
\usepackage{a4,a4wide}

\usepackage{comments} % loading the \comments style

\usepackage{html}     % ATTENTION: This must be loaded after comments.sty
\newcommand{\ThomasLinke}{\htmladdnormallink{Torsten Schaub}{http://www.cs.uni-potsdam.de/~torsten/}}

\title{Examples for \texttt{comments.sty}}
\author{Torsten Schaub}

\stamp % provides an overview of the state of the draft

\begin{document}

\maketitle

\begin{abstract}
  This style is meant to be used for co-authoring \LaTeX-documents via email.
  Most of the features are visible in this file when precessing it with
  \LaTeX;
  pdf\LaTeX\ and \LaTeX2HTML\ are not really supported so that most features
  remain invisible.

  Placeholders like \verb+\tbf+ adjust to the current line width:
  \tbf
  Here is some text to fill the abstract.
  Here is some text to fill the abstract.
  Here is some text to fill the abstract.
  Here is some text to fill the abstract.
  Here is some text to fill the abstract.
  Here is some text to fill the abstract.

  There is also a commented verstion of \verb+\tbf+ called \verb+\tbfc+;
  it looks as follows:
  \tbfc{What the hack should I write\dots}
\end{abstract}


\section{How to get the package?}
\label{sec:package}

Simply click it down:
\begin{itemize}
\item \htmladdnormallink{comments.sty}%
                        {http://www.cs.uni-potsdam.de/~torsten/comments/comments.sty}
\item \htmladdnormallink{ulem.sty}%
%%                         {http://www.ensta.fr/internet/tex/style_macros/ulem.sty.html}
                        {http://www.cs.uni-potsdam.de/~torsten/comments/ulem.sty}
\item \htmladdnormallink{comments.tex}%
                        {http://www.cs.uni-potsdam.de/~torsten/comments/comments.tex}
\item \htmladdnormallink{comments.ps}%
                        {http://www.cs.uni-potsdam.de/~torsten/comments/comments.ps}
\item \htmladdnormallink{comments.pdf}%
                        {http://www.cs.uni-potsdam.de/~torsten/comments/comments.pdf}
\end{itemize}

There are problems with (this) html and pdf version;
the features of of \verb+comments.sty+ do not (yet) fully apply to these formats,
sigh!

\section{Front page}
\label{sec:front:page}

You can add the command \verb+\stamp+ to provide some info about the status of
the current draft on the front page.

This is a patch of the \verb+\date+ command.

\section{Placeholders}
\label{sec:placeholders}

\begin{itemize}
\item \verb+\com+/\verb+\comc+

  \com{This is the basic placeholder comment}

  Commented version:
  \comc{This is the basic placeholder comment}{This is a margin comment!}

\item \verb+\tbf+/\verb+\tbfc+

  \tbf

  Commented version:
  \tbfc{This is a comment!}

\item \verb+\tbr+/\verb+\tbrc+

  \tbr

  Commented version:
  \tbrc{This is a comment!}

\item \verb+\tbc+/\verb+\tbcc+

  \tbc

  Commented version:
  \tbcc{This is a comment!}

\item \verb+\tbrw+/\verb+\tbrwc+

  \tbrw

  Commented version:
  \tbrwc{This is a comment!}

\end{itemize}

\section{Margin comments}
\label{sec:comments}

Margin comments are invoked by means of command \verb+\comment+.
Here is what happens if you write
\begin{verbatim}
Here is and example with a commented comment.\comment{T: Improve your writing!}
\end{verbatim}
\begin{quote}
Here is and example with a commented comment.\comment{T: Improve your writing!}
\end{quote}
As you see all sort of placeholders and/or comments are continuously numbered,
which aims at easier referencing.

\section{\texttt{ulem.sty} based commands}
\label{sec:ulem}

\begin{itemize}
\item Indicating changes
\begin{itemize}
\item \verb+\CHD+

  \CHD{Here} something was changed!

\end{itemize}
\item Indicating deletions
\begin{itemize}
\item \verb+\DEL+

  \DEL{ooops}

\item \verb+\DELc+

  \DELc{oo}{Three `o's are enough}ooops

\end{itemize}

\item Indicating insertions
\begin{itemize}
\item \verb+\INS+

  \INS{Here} something was inserted.

\item \verb+\INSc+

  \INS{Here}{Yipp!} something was inserted.

\end{itemize}

\item Indicating replacements
\begin{itemize}
\item \verb+\REP+

  I would like to replace \REP{that}{this}.

\item \verb+\REPc+

  I would like to replace \REPc{that}{this}{No comment.}.

\item \verb+\REPd+

  I would like to replace \REPd{that}{this}.

\end{itemize}
\end{itemize}

\section{Layout}
\label{sec:layout}

Except for the front page each page has some more information in the header
and the footer.

What needs to be explained is probably the double circle
\[
\bigcirc_R\ \bigcirc_M
\]
in the left part of the footer.
The first cycle is meant to be ``crossed out'' (or ``hooked'' or whatever you
prefer) when the current page is read, while the same is meant to be done once
the page is modified.
Whenever you are through you can do the same with the two circles produced by
the \verb+\stamp+ command ob the front page.


\section{Remerciements}

I am grateful to Marie-Odile Cordier for pointing me to \texttt{ulem.sty}.

\NEW

\label works for comments

\end{document}
