6 files changed, 584 insertions, 3 deletions

diff --git a/doc/context/bib/bibmod-doc.pdf b/doc/context/bib/bibmod-doc.pdf
index abf6359c1..1f74aca09 100644
--- a/doc/context/bib/bibmod-doc.pdf
+++ b/doc/context/bib/bibmod-doc.pdf
diff --git a/doc/context/bib/bibmod-doc.tex b/doc/context/bib/bibmod-doc.tex
index 6d25650dd..b64fd018c 100644
--- a/doc/context/bib/bibmod-doc.tex
+++ b/doc/context/bib/bibmod-doc.tex
@@ -46,7 +46,7 @@
 
 \module
   [       file=bibmod-doc,
-       version=2006.03.13,
+       version=2006.11.04,
          title=Module Documentation,
       subtitle=Bibliographies,
         author={Taco Hoekwater},
@@ -60,7 +60,7 @@
 The bibliographic module (\type{t-bib.tex}) takes care of references
 to publications and the typesetting of publication lists, as well as
 providing an interface between \BIBTEX and \CONTEXT. This manual
-documents version 2006.08.08.
+documents version 2006.09.15.
 
 The bibliographic subsystem consists of the main module
 \type{t-bib.tex}; four \BIBTEX\ styles (\type{cont-xx.bst}); and a set
@@ -182,6 +182,14 @@ heading for \type{\completepublications}
 \NC title\NC The sectioning command.\NC\NR
 \stoptabulate
 
+A fourth option can be used to nullify the printing of `year suffixes'
+in cases where the author(s) has written multiple works within a
+single year.
+
+\starttabulate[|l|p|]
+\NC maybeyear\NC either \type{on} or \type{off}. Default is \type{on}\NC\NR
+\stoptabulate
+
 The other extra options are needed to control micro||typesetting
 of things that are buried deep within macros. There is a separate
 command to handle the larger layout options
@@ -335,6 +343,10 @@ and select the parts that are needed for the current article.
 \setup{setupbibtex}
 
 \starttabulate[|l|p|]
+\NC bibtex\NC The name (with possibly a pathname or even some option settings) 
+   of the bibtex executable. This is passed on to texexec. The default value
+   is simply `bibtex'\NC\NR
+
 \NC database\NC List of bibtex database file names to be
      used. The module will write a very short \type{.aux} file instructing
      \BIBTEX\ to create a (possibly very large) \type{\jobname.bbl} file,
@@ -490,6 +502,15 @@ the default one, you most likely want to call
 \placepublications[criterium=all]
 \stoptyping
 
+If you use a numeric list style combined with multiple , each
+\type{\placepublications} or \type{\completepublications} commands, 
+by default each one restarts the displayed number.  If you do not 
+like that, you can add an option argument like so:
+\starttyping
+\placepublications[option=continue]
+\stoptyping
+
+
 The module uses the following defaults for the generated head:
 \starttyping
 \setupheadtext[en][pubs=References]
@@ -569,7 +590,7 @@ and the meanings are as follows:
 \NC \type{firstnames}  \NC individual (given) name(s)\NC\NR
 \NC \type{inits}  \NC abbreviated form(s) of \type{firstnames}.\NC\NR
 \NC \type{von}    \NC any bits of the family name that are normally disregarded in sorting\NC\NR
-\NC \type{surname}   \NC reaminder of the family (last) name\NC\NR
+\NC \type{surname}   \NC remainder of the family (last) name\NC\NR
 \stoptabulate
 
 
diff --git a/doc/context/document/general/manuals/mreadme.pdf b/doc/context/document/general/manuals/mreadme.pdf
new file mode 100644
index 000000000..338008015
--- /dev/null
+++ b/doc/context/document/general/manuals/mreadme.pdf
diff --git a/doc/context/document/general/manuals/tiptrick.pdf b/doc/context/document/general/manuals/tiptrick.pdf
new file mode 100644
index 000000000..3ced360e1
--- /dev/null
+++ b/doc/context/document/general/manuals/tiptrick.pdf
diff --git a/doc/context/manuals/allkind/mcommon.tex b/doc/context/manuals/allkind/mcommon.tex
new file mode 100644
index 000000000..f0c22cff4
--- /dev/null
+++ b/doc/context/manuals/allkind/mcommon.tex
@@ -0,0 +1,199 @@
+% content=tex
+%
+% copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa
+
+\startenvironment mcommon
+
+% modules
+
+\usemodule[abr-02]
+
+% layout
+
+\startmode[screen]
+  \setuppapersize[S6][S6]
+  \setupinteraction[state=start]
+  \setupinteractionscreen[options=max]
+\stopmode
+
+\setuplayout
+  [footer=0cm,
+   width=middle,
+   height=middle]
+
+% fonts
+
+\startmode[atpragma]
+
+    \startMPenvironment[global]
+      \usetypescriptfile[type-buy]
+      \usetypescript[lucida][texnansi]
+      \setupbodyfont[lucida,10pt]
+    \stopMPenvironment
+
+    \setupbodyfont[11pt]
+
+\stopmode
+
+\startnotmode[atpragma]
+
+    \startMPenvironment[global]
+      \usetypescript[palatino][ec]
+      \setupbodyfont[palatino,10pt]
+    \stopMPenvironment
+
+    \setupbodyfont[11pt]
+
+\stopnotmode
+
+\definefont [BigFont] [SansBold at 60pt]
+\definefont [MedFont] [SansBold at 30pt]
+
+% colors
+
+\setupcolors
+  [state=start]
+
+\definecolor [NopColor] [r=.6,g=.4,b=.5]
+\definecolor [AltColor] [r=.4,g=.6,b=.5]
+\definecolor [TheColor] [r=.4,g=.5,b=.6]
+\definecolor [TmpColor] [r=.6,g=.5,b=.4]
+
+\definecolor [red]   [NopColor]
+\definecolor [green] [AltColor]
+\definecolor [blue]  [TheColor]
+\definecolor [yellow][TmpColor]
+
+% spacing
+
+\setupwhitespace
+  [big]
+
+\setuptolerance
+  [verytolerant,stretch]
+
+% verbatim
+
+\setuptype
+  [color=AltColor]
+
+\setuptyping
+  [color=AltColor]
+
+% structure
+
+\setupitemize
+  [each]
+  [color=TheColor]
+
+\definedescription
+  [switch]
+  [headstyle=type,
+   headcolor=TheColor,
+   location=serried,
+   width=broad]
+
+\defineenumeration
+  [topic]
+  [location=serried,
+   width=broad,
+   headstyle=,
+   headcolor=TheColor,
+   text=,
+   left={[},
+   right={]}]
+
+\setuphead
+  [section]
+  [style=\ss\bfb,
+   color=TheColor]
+
+\setuplist
+  [section]
+  [alternative=c,
+   color=TheColor,
+   textcolor=black,
+   pagecolor=black]
+
+% whatever
+
+\setupsystem
+  [random=medium]
+
+\setupfloats
+  [ntop=100]
+
+\setupinteraction
+  [style=,
+   color=NopColor,
+   contrastcolor=NopColor]
+
+% tables and frames
+
+\setuptabulate
+  [rulethickness=.5pt,
+   rulecolor=AltColor]
+
+\setuptables
+  [rulethickness=.5pt,
+   rulecolor=AltColor]
+
+\setupframedtexts
+  [rulethickness=.5pt,
+   framecolor=TheColor,
+   width=\textwidth]
+
+% quick reference things
+
+\usemodule[set-11] \loadsetups
+
+\setupframedtexts
+  [setuptext]
+  [rulethickness=.5pt,
+   framecolor=AltColor]
+
+% basic titlepage and colofon, a bit old fashioned approach, but let's not
+% modernize everything now
+
+\def\TitlePage#1#2#3#4#5% number/name angle title author screen
+  {\doifnumberelse{#1}
+     {\ifcase#1
+        \defineoverlay
+          [logo]
+          [\useMPgraphic{titlepage}{width=\overlaywidth,height=\overlayheight}]
+      \else
+        \startMPrun
+          logo_type := #1 ; mpgraph := #1 ; input mp-cont ;
+        \stopMPrun
+        \defineoverlay
+          [logo]
+          [{\externalfigure
+              [\MPrunfile{#1}]
+              [width=\overlaywidth,height=\overlayheight]}]
+      \fi}
+     {\defineoverlay
+        [logo]
+        [\useMPgraphic{#1}{width=\overlaywidth,height=\overlayheight}]}
+   \setupbackgrounds
+     [page]
+     [background=logo]
+   \definecolor[Gray][s=#5]
+   \startstandardmakeup
+     \dontcomplain
+     \BigFont \setupinterlinespace \vfill \setupalign[left] \let\\=\par
+     \ifcase#2\relax
+       \noindent\color[Gray]{#3}\par
+     \else
+       \noindent\rotate[rotation=#2]{\color[Gray]{#3}}\par
+     \fi
+   \stopstandardmakeup
+   \setupbackgrounds
+     [page]
+     [background=]}
+
+\def\ColofonPage
+  {\startstandardmakeup
+     \vfill \setups [pragma-colofon]
+   \stopstandardmakeup}
+
+\stopenvironment
diff --git a/doc/context/manuals/allkind/mreadme.tex b/doc/context/manuals/allkind/mreadme.tex
new file mode 100644
index 000000000..22af40afe
--- /dev/null
+++ b/doc/context/manuals/allkind/mreadme.tex
@@ -0,0 +1,361 @@
+% interface=en output=pdftex language=uk
+%
+% copyright=pragma-ade readme=readme.pdf licence=cc-by-nc-sa
+
+\environment mcommon
+
+\useurl[gpl-simple]   [http://creativecommons.org/licenses/GPL/2.0/]
+\useurl[gpl-legal]    [http://creativecommons.org/licenses/GPL/2.0/legalcode]
+\useurl[byncsa-simple][http://creativecommons.org/licenses/by-nc-sa/2.5/]
+\useurl[byncsa-legal] [http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode]
+
+\useurl[garden]       [http://contextgarden.net]
+\useurl[contextlist]  [http://www.ntg.nl/mailman/listinfo/ntg-context]
+\useurl[development]  [http://www.ntg.nl/mailman/listinfo/dev-context]
+\useurl[announce]     [http://www.ntg.nl/mailman/listinfo/ann-context]
+\useurl[collector]    [http://context.literatesolutions.com]
+\useurl[pragma]       [http://www.pragma-ade.com]
+\useurl[mirror]       [http://context.aanhet.net]
+
+\setupinteraction[state=start]
+
+% copied from cont-log: readme_logo
+
+\startuseMPgraphic{titlepage}{width,height}
+  numeric width ; width = \MPvar{width} ;
+  numeric height ; height = \MPvar{height} ;
+  numeric delta ; delta := width/10 ;
+  numeric circle ; circle := 2.5delta ;
+  color c ; c := (.2,.4,.6) ;
+  path p, q, r ;
+  p := unitsquare xscaled width yscaled height ;
+  z1 = (delta,height-2delta) ;
+  z2 = (width-delta,height-delta) ;
+  z3 = (width/2-delta,2delta+circle) ;
+  z4 = (x3,delta+circle/2) ;
+  q := z1 { dir  -15 } .. z2 &
+       z2 { dir -105 } .. z3 &
+       z3 { dir  135 } .. z1 &
+       cycle ;
+  r := fullcircle xscaled circle yscaled (.85circle) rotated 15 shifted z4 ;
+  pickup pencircle scaled (delta/1.5) ;
+  fill p withcolor .50c ;
+  fill q withcolor .75c ;
+  fill r withcolor .75c ;
+  draw p withcolor    c ;
+  draw q withcolor    c ;
+  pickup pencircle scaled (delta/2) ;
+  draw r withcolor    c ;
+  setbounds currentpicture to p ;
+\stopuseMPgraphic
+
+\starttext
+
+\TitlePage{titlepage}{90}{Read Me First}{}{1}
+
+\subject {Introduction}
+
+What licence suits best for a \TEX\ like system is a matter of
+taste. Personally we dislike any licence that needs more than a few
+pages of dense legal code to get the message accross. A \TEX\
+related system like \CONTEXT\ is a hybrid of programs, scripts
+and|/|or macro code as well as documentation and sample code,
+including graphics. \TEX\ related systems also have a long
+standing tradition of providing support structures for users. In
+order to make support feasable, a \TEX\ based system like
+\CONTEXT\ assumes a certain logic and structure in the way the
+related files are named and organized in a tree structure. Even a
+small change in one of the elements may let such a system behave
+differently than manuals suggest. Swap a font, change some style
+defaults, leave out some pieces, and users may end up in
+confusion. A licence does not give a user any guarantees!
+
+In order to satisfy those responsible for distributing \CONTEXT,
+we need to choose a licence that makes them feel comfortable.
+Unfortunately we don't feel that comfortable with a licence that does
+not provide the guarantees that a system will not be adapted in
+such ways that the advertised behaviour changes. On the
+other hand, it is the responsibility of those distributing and
+extending the system to make sure that this does not happen.
+However, users should not automatically assume that what they get
+shipped is the same as the original, which is why we stress that
+support (from our side) will only be given on unaltered systems.
+
+First of all, what is \CONTEXT ? It's just a bunch of macros,
+written in \TEX\ and \METAPOST, meant for typesetting documents.
+The macros are accompanied by some scripts, written in \PERL\ (mainly
+the older scripts) \RUBY\ (the official ones) and \LUA\ (for
+embedded usage). The \CONTEXT\ distribution comes with a few fonts,
+files that help manage resources (e.g.\ map files), as well as
+patterns (based on official ones, so this is a derived work).
+
+The \CONTEXT\ distribution is packaged in a zip file organized in
+the \TDS\ structure.
+
+\starttabulate
+\NC \type {cont-tmf.zip} \NC The main distribution. \NC \NR
+\NC \type {cont-img.zip} \NC A few extra resources. \NC \NR
+\NC \type {cont-ext.zip} \NC Third party modules.   \NC \NR
+\stoptabulate
+
+When we talk about \CONTEXT\ we also mean its graphical companion
+\METAFUN\ and \FOXET, an \XML\ related product. All these are
+included in the main distribution archive.
+
+The documentation can be downloaded from our website, one of its
+mirrors, the \TEX\ collection as distributed by \TEX\ user groups.
+For some manuals, source code is available in a subversion
+repository. The archives are also kept on \CTAN.
+
+That said, what licence does apply? We need to distinguish between
+things that resemble a program on the one hand and documentation
+on the other hand. We (currently) use a different licence for
+either of them.
+
+\subject {The Code}
+
+The program code (i.e. anything not under the \type {/doc}
+subtree) is distributed under the
+
+\startnarrower
+\goto{Creative Commons GNU GPL}[url(gpl-simple)]
+\stopnarrower
+
+For practical purposes distributers may also choose the \LATEX\
+project licence, which is considered to be a bit more \TEX\
+friendly. (BSD alike licences, the Ruby Licence and the Apache
+are all licences that apply well for \CONTEXT.)
+
+In practice, users may forget about the legal part, if only
+because I haven't even read (and understood) it completely myself,
+so let's stick to what Creative Commons makes of it:
+
+\startcolor[blue]
+The GNU General Public License is a Free Software license. Like
+any Free Software license, it grants to you the four following
+freedoms:
+
+\startitemize
+\item The freedom to run the program for any purpose.
+\item The freedom to study how the program works and adapt it to
+      your needs.
+\item The freedom to redistribute copies so you can help your neighbour.
+\item The freedom to improve the program and release your improvements
+      to the public, so that the whole community benefits.
+\stopitemize
+
+You may exercise the freedoms specified here provided that you
+comply with the express conditions of this license. The principal
+conditions are:
+
+You must conspicuously and appropriately publish on each copy
+distributed an appropriate copyright notice and disclaimer of
+warranty and keep intact all the notices that refer to this
+License and to the absence of any warranty; and give any other
+recipients of the Program a copy of the GNU General Public License
+along with the Program. Any translation of the GNU General Public
+License must be accompanied by the GNU General Public License.
+
+If you modify your copy or copies of the program or any portion of
+it, or develop a program based upon it, you may distribute the
+resulting work provided you do so under the GNU General Public
+License. Any translation of the GNU General Public License must be
+accompanied by the GNU General Public License.
+
+If you copy or distribute the program, you must accompany it with
+the complete corresponding machine-readable source code or with a
+written offer, valid for at least three years, to furnish the
+complete corresponding machine-readable source code.
+
+Any of these conditions can be waived if you get permission from
+the copyright holder.
+
+Your fair use and other rights are in no way affected by the above.
+\stopcolor
+
+\subject {Recommendations}
+
+Here are a few recommendations in case you want to distribute,
+extend of embed \CONTEXT\ in applications:
+
+\startitemize
+
+\item You can best leave the code base untouched. Most of
+\CONTEXT\ provides hooks and it's relatively easy to overload
+code. Leave the lower level system code untouched: changes may
+backfire when you update. Asking for more hooks is the best way to
+go.
+
+\item Put your own code in the right subpaths, i.e.\ modules
+approved by the development team under \type {.../third}, and
+styles and whatever else under \type {.../user}. This way your
+code will not interfere with existing code and updating will give
+less problems. Keep in mind that \TEX\ systems have their own way
+and order in locating files, and the load order often matters.
+
+\item Don't copy styles and change a few lines, but load the base one
+and built|/|patch on top of that. In the end you may benefit from
+improvements to the base style.
+
+\item Be original. The whole idea behind \CONTEXT\ is that you can
+write your own styles. On the \CONTEXT\ mailing list as well as on
+the Wiki there are enough advanced users to help you make a start.
+
+\item Don't hesitate to submit bugs reports and ask for
+extensions. It may even be that what you want is already present
+but yet undocumented.
+
+\item If things don't work as expected, check to what extend your
+system matches the (more or less) standard. We provide so called
+minimal \CONTEXT\ trees that can serve as a reference. Because
+\CONTEXT\ evolves, make sure your system is up to date.
+
+\item The scripts can best be called using \type {texmfstart}. This
+lessens dependencies on the location in the tree and ensures upward
+compatibility. It also prevents clashes with similary named scripts.
+
+\item Some scripts depend on each other. Don't mess around with the
+existing functionality and names of the scripts and then feed them
+back into the standard distributions.
+
+\stopitemize
+
+\subject {Documents}
+
+The documentation is provided under another Creative Commons licence
+
+\startnarrower
+\goto{Attribution NonCommercial ShareAlike}[url(byncsa-simple)]
+\stopnarrower
+
+This one says:
+
+\startcolor[blue]
+You are free:
+
+\startitemize
+\item to copy, distribute, display, and perform the work
+\item to make derivative works
+\stopitemize
+
+{\sc Attribution:} You must attribute the work in the manner
+specified by the author or licensor.
+
+{\sc NonCommercial:} You may not use this work for commercial
+purposes.
+
+{\sc Share Alike:} If you alter, transform, or build upon this
+work, you may distribute the resulting work only under a license
+identical to this one.
+
+\startitemize
+\item For any reuse or distribution, you must make clear to others
+      the license terms of this work.
+\item Any of these conditions can be waived if you get permission from
+      the copyright holder.
+\stopitemize
+
+Your fair use and other rights are in no way affected by the above.
+\stopcolor
+
+The non||commercial part is mostly a safeguard. We don't mind if
+user groups distribute printed copies, publish (parts of) manuals
+and|/|or if authors use example code in manuals and books about
+\CONTEXT.
+
+If you distribute \CONTEXT\ and related software on electronic media
+as part of \TEX\ distributions (either or not for money), you may
+also distribute the manuals and their sources in electronic form,
+preferable as provided by the maintainers of \CONTEXT.
+
+Keep in mind that logos and cover designs are not meant to be
+copied. We provide the source code for some manuals, but we don't
+always provide all graphics and other resources. For instance, in
+some manuals we use commercial fonts and you have to buy those
+yourself.
+
+We provide the typeset manuals at our website. Those are the official
+ones. We appreciate it if you do not to distribute manuals compiled
+on your own system as substitutes. The manuals are a showcase for what
+\CONTEXT\ provides. Help us to assure the quality.
+
+\subject {More information}
+
+We're not going to fill \mathematics{n}~pages with legal stuff, so if
+you want to know more, you have to consult the web for the legalities
+mentioned. Here are a few starting points:
+
+\startlines
+\goto{\url[gpl-simple]}[url(gpl-simple)]
+\goto{\url[gpl-legal]}[url(gpl-legal)]
+\stoplines
+
+\startlines
+\goto{\url[byncsa-simple]}[url(byncsa-simple)]
+\goto{\url[byncsa-legal]}[url(byncsa-legal)]
+\stoplines
+
+\CONTEXT\ itself can be fetched from the main site or its primary mirror:
+
+\startlines
+\goto{\url[pragma]}[url(pragma)]
+\goto{\url[mirror]}[url(mirror)]
+\stoplines
+
+A starting point for support can be found at:
+
+\startlines
+\goto{\url[contextlist]}[url(contextlist)]
+\goto{\url[garden]}[url(garden)]
+\stoplines
+
+Bugs and feature requests can be registered at the collector:
+
+\startlines
+\goto{\url[collector]}[url(collector)]
+\stoplines
+
+Releases are announced at:
+
+\startlines
+\goto{\url[announce]}[url(announce)]
+\stoplines
+
+The developers can be met at:
+
+\startlines
+\goto{\url[development]}[url(development)]
+\stoplines
+
+\subject {Disclaimer}
+
+To play safe we include a disclaimer here, taken from the BSD style
+licence. For some reason such a text is in capitals, so \unknown
+
+\start \sc \blue
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR \quotation {AS IS} AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+\stop
+
+\unknown\ and don't bother discussing licence issues and related things
+with us for the mere sake of discussing licence stuff.
+
+\blank[2*big]
+
+\startlines
+Hans Hagen
+PRAGMA ADE
+Hasselt NL
+\stoplines
+
+\ColofonPage
+
+\stoptext