% \iffalse 
% file: procIAGssymp.dtx
% author: Battista Benciolini
% date: 2024-04-08
%\fi
% \iffalse 
%<*ins>
\begingroup
\input docstrip.tex
\keepsilent
\preamble
-------------------------------------------------------------
This file is part of the distribution of  procIAGssymp.
The author is Battista Benciolini 
benciolinibattista al gmail dot com
-------------------------------------------------------------
The package provides (re-)definitions of some LaTeX commands 
that can be useful for the preparation of a paper with 
the style of the proceeding of symposia sponsored by the 
International Association of Geodesy (IAG).
-------------------------------------------------------------
This program may be used, distributed and modified under 
the conditions of the LaTeX Project Public License.
(see: http://www.latex-project.org/lppl.txt)
-------------------------------------------------------------
\endpreamble
\askforoverwritefalse
\generate{\file{procIAGssymp.sty}{\from{procIAGssymp.dtx}{package}}}
\generate{\file{TESTprocIAGssymp.tex}{\from{procIAGssymp.dtx}{example}}}
\endgroup
%</ins>
%\fi
% \iffalse 
%<*driver>
\documentclass[a4paper,10pt]{ltxdoc} % 
\title{The package \texttt{procIAGssymp}}
\author{Battista Benciolini\thanks{contact: benciolinibattista al gmail dot com}}
\parindent=0pt
\begin{document}
\maketitle 
\DocInput{procIAGssymp.dtx}
\end{document}
%</driver>
% \fi
% \section{Introduction and warnings} The package |procIAGssymp.sty| has  
% been designed to help the  formatting of a paper with the style 
% of the proceedings of symposia sponsored by the 
% International Association of Geodesy (IAG).
% \par 
% I have not recently checked the instruction from 
% the publisher of the proceedings of IAG-sponsored-symposia. 
% They probably changed since the time this code has been prepared. 
% I presume that official more refined and 
% up-to-date class or style files 
% are now available from the publisher.
% This package is therefore not as useful 
% as it was at the time of it's first publication, 
% but it is pehaps still conveniet for some user.
% \par
% The release of this package on CTAN is a personal initiative 
% of its author. The mention of IAG and of the publisher 
% of the proceedings of the symposia sponsored by IAG does 
% not imply any involvement of these entities in this initiative. 
% \section{The use of \texttt{procIAGssymp.sty}}
% \subsection{General informations}
% Some of the informations of these section are repeated 
% in the test article that is distributed with the package.
% \par
% The reccommended class (with option) is:
% |[a4paper,twocolumn,10pt]{article}|. 
% \subsection{Top-matter}
% The title and the (list of) author(s) must be prepared with 
% \DescribeMacro{\title} 
% \DescribeMacro{\author}
% |\title{ . . .}| and |\author{ . . .}| and they will be 
% printed by |\maketitle|. 
% If there are several authors, their 
% \DescribeMacro{\and}
% names must be separated by |\and|. 
% \DescribeMacro{\thanks}
% The authors that share the 
% same address must be listed consecutively and must be followed by 
% |\thanks{. . .}| (with the address as argument).  
% The use of |\thanks{. . .}| referred  
% to the title is not appropriate because this command has been redefined. 
% \subsection{Sectioning}
% \DescribeMacro{\section} % \DescribeMacro{\subsection}
% The use of |\section{. . . }|  and |\subsection{. . . }|
% can be done as in any \LaTeX\ paper. 
% These commands have been redefined so that they 
% produce the first level and second level headers in the proper format. 
% All the other sectioning commands have been redefined with a coherent style. 
% The command |\section*{References}| can be used to start the reference list. 
% \subsection{Technicalities about the format of the top-matter}
% The main structure of the topmatter is governed by |\@maketitle| 
% which is properly redefined. 
% The command |\thanks| has been redefined to print the 
% authors' address immediately after the authors' names. 
% The  new form of this command makes it unsuitable 
% to put a note to the title.
% % 
% \section{Acknowledgment}
% People listed here after contributed with suggestions.
% Some of them also provided fragments of code. 
% {\large Claretta Carrara, Nico Snew, Claudio Beccari.}
% % 
% \section{Code of \texttt{procIAGssymp.sty}}
% \iffalse
%<*package>
% \fi
%    \begin{macrocode}
\ProvidesPackage{procIAGssymp}[2024/04/08]
%    \end{macrocode}
% \begin{macro}{\@maketitle}
% The following redefinition of |\@maketitle| is quite simplified with
% respect to the standard one. The data is not printed; the title is
% not centered and it is in sans-serif style; the author is no longer
% in tabular environment; the author and its address are left justified. 
%    \begin{macrocode}
\def\@maketitle{%
 {\LARGE\sffamily\bfseries\@title}
   \vskip 6mm%
   {\lineskip .5em%
         {\raggedright\@author}}       
   \vskip 6mm%
 \par
 \vskip 1.5em}
%    \end{macrocode}
%\end{macro}
% 
% The proper behaviour of the command |\and| in relation with |\thanks|
% require the new conditional named |\ifafterthanks|. 
% It will be used in the redefinition of |\and|.
%    \begin{macrocode}
\newif\ifafterthanks \afterthanksfalse
%    \end{macrocode}
% \begin{macro}{\thanks}
% The macro |\thanks| must be redefined to print the address immediately after 
% the author(s) it refers to.
%    \begin{macrocode}
\renewcommand{\thanks}[1]{\\ #1 \vskip6mm \global\afterthankstrue}
%    \end{macrocode}
%\end{macro}
% \begin{macro}{\and}
% The macro|\and| must be redefined.
%    \begin{macrocode}
\renewcommand{\and}{\ifafterthanks\relax \else{\unskip,}\ \fi
\global\afterthanksfalse}
%    \end{macrocode}
%\end{macro}
%
% \begin{macro}{\section}
% The command |\section| is redefined to use proper shape and proper spacing. 
%    \begin{macrocode}
\renewcommand\section{\@startsection%
{section}{1}{0mm}{-3mm}{2mm}%
{\fontsize{10.95}{13.6}\selectfont\sffamily\bfseries}}%
%    \end{macrocode}
%\end{macro}
% \begin{macro}{\subsection}
% The command |\subsection| is redefined to use proper shape and proper spacing. 
%    \begin{macrocode}
\renewcommand\subsection{\@startsection%
{subsection}{2}{0mm}{-3mm}{2mm}%  
{\normalfont\sffamily\bfseries}}%
%    \end{macrocode}
%\end{macro}
% The first and second order sectioning are generally used. The
% lower lever sectioning commands are redefined for compatibiliy.
%    \begin{macrocode}
\renewcommand\subsubsection{\@startsection%
{subsubsection}{3}{0mm}{-2mm}{2mm}% 
{\normalfont\normalsize\sffamily\bfseries}}% 
\renewcommand\paragraph{\@startsection%
{paragraph}{4}{0mm}{-2mm}{-1em}%
{\normalfont\normalsize\sffamily\bfseries}} %
\renewcommand\subparagraph{\@startsection%
{subparagraph}{5}{\parindent}{-2mm}{-1em}%  
{\normalfont\normalsize\sffamily\bfseries}}%
%    \end{macrocode}
% It is also necessary to set some dimensions.
%    \begin{macrocode}
\textheight224mm
\textwidth156mm
\columnsep8mm
\topmargin0mm
%    \end{macrocode}
%\begin{macro}{\linea}
% The new command  |\linea|,  with Italian name   -:) ,   
% can be used to put some space and a rule after the abstract.
%    \begin{macrocode}
\newcommand{\linea}{\vskip1mm\noindent\rule{74mm}{.5pt}}
%    \end{macrocode}
%\end{macro}
% \iffalse
%</package>
% \fi
% \section{Code of \texttt{TESTprocIAGssymp.tex}}
% The code of |TESTprocIAGssymp.tex| is presented here after. 
% \iffalse
%<*example>
% \fi
%    \begin{macrocode}
\documentclass[a4paper,twocolumn,10pt]{article} % 
\usepackage{procIAGssymp}   
\title{The package procIAGssymp.sty for the formatting  
       of a paper with the style of the proceedings of 
       symposia sponsored by IAG}
\author{B.Benciolini\thanks{contact: benciolinibattista al gmail dot com}
\and  No Second Author \and  No Third Author\thanks{No-Where Institute}}
\hbadness=10000   \vbadness=10000
\begin{document}
\maketitle 
\paragraph{Abstract}  The use of the package \texttt{procIAGssymp.sty} 
is explained and tested in this short paper. 
\linea
\section{Introduction}
The package \texttt{procIAGssymp.sty} provides some (re-)definitions 
of \LaTeX\ commands. The main pourpose of the present text is to give 
an example of the use of the package \texttt{procIAGssymp.sty}. 
The content is just an essential explenation of the use of the same package.
\par\noindent Please refer to the file \texttt{procIAGssymp.pdf}  for 
a complete documentation and to \texttt{README.txt} for general 
introductory information. 
\section{Suggestions for the user}
\subsection{General page lay-out}
The general lay-out of the pages is controlled by some assignment 
made by \texttt{procIAGssymp.sty} and by the use of the class 
\texttt{article} that must be loaded with the proper options, i.e. 
\verb+[a4paper,twocolumn,10pt]+.
\subsection{Top-matter}
The title and the author(s) must be prepared with 
\verb+\title{ . . .}+  and \verb+\author{ . . .}+ and they will be 
printed by \verb+\maketitle+.  
If there are several authors, their names must be separated by \verb+\and+. 
The authors that share the same address must be listed consecutively and must 
be followed by \verb+\thanks{. . .}+ (with the address as argument). 
The use of \verb+\thanks{. . .}+ referred  to the title is not appropriate 
because this command has been redefined. 
\subsection{More about the format of the top-matter}
The main structure of the topmatter is governed by \verb+\@maketitle+ 
which is properly redefined.  \par\noindent
The command \verb+\thanks+ has been redefined to print the 
authors' address immediately after the  authors' names. 
The  new form of this command makes it unsuitable 
to put a note to the title.
\subsection{Sectioning}
The use of \verb+\section{. . . }+  and \verb+\subsection{. . . }+
can be done as in any \LaTeX\ paper. 
These commands have been redefined so that they 
produce the first level and second level headers in the proper format. All
the other sectioning commands have been redefined with a coherent style. The 
command \verb+\section*{References}+ can be used to start the reference list. 
One of the following sections is just a test of the various sectioning commands.
\section{Test of sectioning (1st level)} 
\subsection{Test of sectioning (2nd level)} 
\subsubsection{Test of sectioning (3rd level)} 
This is just an example of the use and abuse 
of \verb+\section+, \verb+\subsection+ and
\verb+\subsubsection+. We can also test \verb+\paragraph+ and 
\verb+\subparagraph+.
\paragraph{Paragraph} This is a paragraph, headed by \verb+\paragraph+.
\subparagraph{Subparagraph} This is a  sub paragraph. And the section 
ends here. 
\section{History}
\begin{description}
\item[2000 ... 2002:] development, test, in-house use,
\item[2002] first released in CTAN,
\item[2022-05-05] general revision,  
changes in the comments and documentation, new release in CTAN,
\item[2024-04-08] general revision, changes in the documentation, 
all stuff collected in \texttt{procIAGssymp.dtx},
new release in CTAN.
\end{description}
\section{Recommendation}
I recommend all the users of the package \texttt{procIAGssymp.sty}
to send me any comment about it. 
\end{document}
\endinput
%    \end{macrocode}
% \iffalse
%</example >
% \fi
% 
% \iffalse
% The END
% -------
% \fi
% \vfill\centerline{\large ***}\vfill 
% 
