Message-Id: <199208211628.AA00525@mail.cs.tu-berlin.de>
Reply-To: Mailing list for the LaTeX3 project <LATEX-L%DHDURZ1@tubvm.cs.tu-berlin.de>
Date:         Fri, 21 Aug 92 17:25:25 BST
From: CA_ROWLEY@VAX.ACS.OPEN.AC.UK
Sender: Mailing list for the LaTeX3 project <LATEX-L%DHDURZ1@tubvm.cs.tu-berlin.de>
To: Multiple recipients of <LATEX-L%DHDURZ1@tubvm.cs.tu-berlin.de>
Subject:      Re: heading names and question
Status: R


> I would invite you to suggest a set of parameters describing ``display
> headings'' + giving an algorithm for using the parameters in various
> circumstances. With display heading I mean headings which are
> separated by vertical skips from preceding and following text.
>
> Answers?
>
> Frank


Here is something I found in one of our production system files.

It is an outline of how to set up various levels of head and specify
the formatting, within very narrow bounds.

It covers run-in as well as `display headings'.

I hope that it serves to get the discussion going.


chris

% DOCUMENTATION of OUSECS.STY
%
Many of these details need not concern anyone except the designer (not that
others cannot take an interest!).


%     *****************************************
%     *              SECTION HEADS            *
%     *****************************************
%

%%%%%%%%%%%%%%%%%%%%%%
% From LATEX.TEX:
% \@hangfrom{TEXT} : Puts TEXT in a box, and makes a hanging indentation
%    of the following material up to the first \par.  Should be used
%    in vertical mode.
%
%\def\@hangfrom#1{\setbox\@tempboxa=\hbox{#1}%
%      \hangindent 1\wd\@tempboxa\noindent\box\@tempboxa}

% Initializations
%  From LATEX.TEX:
%
% \def\sectionmark#1{}
% \def\subsectionmark#1{}
% \def\subsubsectionmark#1{}
% \def\paragraphmark#1{}
% \def\subparagraphmark#1{}


Interface:

The designer interface consists of two commands, here are
   examples: they define \section and \finale as commands whose syntax
   is identical to the sectioning commands in standard LaTeX 2.09:

\designverthead{section}{\@aboveheadbtobskip 6pc plus 2pc minus 1.5pc
                         \@belowheadbtobskip 24pt
                         \def \@headbreak {\minpagespace{0.2\textheight}}
                         \def \@headstyle {\size{20}{24pt} \defaultheadfont}}

\designrunonhead{finale}{\@aboveheadbtobskip 18pt plus 6pt
                         \@afterrunonheadsep 1pc
                         \let \@headbreak \relax
                         \def \@headstyle {\bf}}


% These need setting for all Heads:

  % This space deliberately empty!

% These need setting (unless default values OK):

defs-or-lets:
 \@headprenumbertext % if any: ie default is "no text before number"

 \@headbreak         % controls page-breaking before head

 \@headstyle         % title font and size
 \@headpretitlefont  % if not same as title font

lengths:
 \@aboveheadbtobskip % rubber length ---
		     % this is used via \btobminvspace, so it is the
		     % minimum space above the head.
 \@afternumbersep    % rubber length
 \@pretitlesep       % rubber length

numbering: default is arabic numbering of non-starred versions---
           numbering can be turned off completely (\nonumbers)---
           all numbering and pretitle decisions can be over-ridden in
           \@headstyle if necessary: but take care!

toc and marks: default is toc-entry only for non-starred versions
                   (changed by explicit \addcontentsline or by
                    redefining \...tocentry)
               but no marks (changed by explicit \markboth or by
                             redefining \...mark)


% These need setting for Vertical Heads (unless default values OK):

lengths:
 \@belowheadbtobskip % rubber length

% These need setting for Runon Heads (unless default values OK):

lengths:
 \@afterrunonheadsep % rubber length


% Further customising (do this only under supervision):

These can be redefined to produce different layouts for the
  "pre-title" part of the head:

\@setpretitle

These can be redefined to give greater flexibility (eg to make them
   distinct):

\@headtype      : this is #1 unless reset in #2 (used by TOC etc)

\@headcounter   : this is #1 unless reset in #2 (used for numbering)
                    ---any alternative counter must be declared
                       by \newcounter