stable 2006.07.13 22:26

3 files changed, 116 insertions, 46 deletions

diff --git a/doc/context/bib/bibmod-doc.pdf b/doc/context/bib/bibmod-doc.pdf
index 4a5aa523d..d56562ecc 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 b1ba4dcc3..32daa3168 100644
--- a/doc/context/bib/bibmod-doc.tex
+++ b/doc/context/bib/bibmod-doc.tex
@@ -5,6 +5,7 @@
 \setupcolors[state=start]
 
 \usemodule[bib,set-11,mod-01]
+
 \setuppublications[alternative=num]
 
 \startXMLmapping[zero]
@@ -33,7 +34,7 @@
 \title{\CONTEXT\ Publication Module, The user documententation}
 \pubyear{2006}
 \note{In case you didn't know: it's the document you are reading now}
-\pages{12}
+\pages{14}
 \stoppublication
 \stopbuffer
 
@@ -59,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.03.13.
+documents version 2006.06.16.
 
 The bibliographic subsystem consists of the main module
 \type{t-bib.tex}; four \BIBTEX\ styles (\type{cont-xx.bst}); and a set
@@ -78,7 +79,7 @@ A typical input file obeys following structure:
 main text of the article. The source of these definitions can be
 a combination of:
     \startitemize
-    \item THe \type{\jobname.bbl} file (automatically read at \type{\starttext})
+    \item The \type{\jobname.bbl} file (automatically read at \type{\starttext})
     \item extra bbl files
     \item a file or inline macros before \type{\starttext}
     \stopitemize
@@ -86,7 +87,7 @@ a combination of:
     only important to realize that of all these definitions have to be known
     {\it before} the first citation in the text.
 \item \type{\starttext}
-\item The body text, with a number of \type{\cite} commands.
+\item The body text, with a number of \type{\cite} and \type{\nocite} commands.
 \item The list of publications, called using the command
     \type{\placepublications} or the command\break \type{\completepublications}.
 \item \type{\stoptext}
@@ -138,7 +139,7 @@ allowing you to override specific settings from the chosen style.\NC\NR
      means that all referred-to publications are listed 
      before all others, otherwise (if `sorttype' equals `bbl') you will
      just get a typeset version of the used database(s).\crlf
-     The default for apa is `used'\NC\NR
+     The default for apa is `used'.\NC\NR
 \NC numbering\NC Whether or not the  publication list
      should be labelled and if so, how. \type{yes} uses the item number in
      the publication list as label. \type{short} uses the short
@@ -150,15 +151,20 @@ allowing you to override specific settings from the chosen style.\NC\NR
      hanging indent should be re-calculated based on the real size of the
      label. This option only applies if numbering is turned on.\crlf
      The default is `no'.\NC\NR  
+\NC monthconversion\NC The presentation form of any month field, if it
+     is entered in the database as a numeric value. The default is to
+     typeset the number without any conversion\NC\NR
 \stoptabulate
 
 \subsection{How the entries are formatted: \type{\setuppublicationlist}}
 
 \setup{setuppublicationlist}
 
-The list of publications at the end of the article is essentially a
-normal context `list' that behaves much like the list that defines the
-table of contents, with the following changes:
+The list of publications at the end of the article is comparable with
+a sequence of normal \CONTEXT\ `list items' that behaves much like the
+list that defines the table of contents. {\it In previous versions, it was 
+in fact implemented as a `normal' \CONTEXT\ list, but this is no
+longer the true.\/}
 
 The module defines a set of extra options. These option names are static, they
 do {\it not} change to follow the selected \CONTEXT\ interface language.
@@ -201,7 +207,7 @@ macros provide formatting that looks like this:
 }
 As you can see in the examples, there is a connection between certain
 styles of displaying a name and the punctuation used. Punctuation in
-this document has been set up by the `ap' style, and that style makes
+this document has been set up by the `apa' style, and that style makes
 sure that \type{\invertedshortauthor} looks good, since that is the default
 command for `apa' style. (Keep in mind that the comma at the end of the
 author will be inserted by either `namesep' or `lastnamesep'.)
@@ -224,27 +230,7 @@ but commands can be a lot simpler, like this:
 \setuppublicationlist[editor=\surnameonly]
 \stoptyping
 
-
-Apart from these extra options,
-the module itself sets some of the options to the internal call to
-\type{\setuplist} itself.
-
-To get a reasonable layout for the reference list, the following are
-set as a precaution:
-\starttabulate[|l|p|]
-\NC alternative\NC Always re-initialized to `a'. This makes sure that no
-space is allocated for the page number.\NC\NR
-\NC pagenumber\NC Always re-initialized to `no'. The list is a bit of
-a special one, and page numbers don't make much sense. All entries
-will have the same page number: the number of the page on
-which \type{\placepublications} was called.\NC\NR
-\NC interaction\NC Alway made empty. There should never be any
-interactivity in the list of publications, because the entries all
-point to themselves (this limitation is similar to one for `pagenumber').
-\stoptabulate
-
-
-And also, the following options are initialized depending on the
+The following options are initialized depending on the
 global settings for `numbering' and `autohang':
 \starttabulate[|l|p|]
 \NC width\NC Set to the calculated width of the largest label, but only if autohang is `yes'\NC\NR
@@ -361,9 +347,21 @@ files cannot be found (the \type{.tuo} file is needed to get correct
 page references for \type{\cite[page]}).
 
 
+\subsection{Legacy database support}
+
+Old \BIBTEX\ databases tend to contain \LaTeX-specific commands and,
+especially, command||definitions. To make it easier to handle these
+databases, a support module that defines a simplified version of
+\LaTeX's \type{\newcommand} is shipped alongside the bib module. 
+You can load this support code by adding
+\starttyping
+\usemodule[bibltx]
+\stoptyping
+to your document preamble.
+
 \section{Citations}
 
-Citations are handled through the \type{\cite} command.
+Citations are normally handled through the \type{\cite} command.
 
 \type{\cite} has two basic appearances:
 
@@ -420,6 +418,7 @@ Three of the options are combinations:
 \starttabulate[|l|l|p|]
 \NC authoryear\NC  \cite[authoryear][me]\NC(from `a' and `y')\hfil\NC\NR
 \NC authoryears\NC \cite[authoryears][me]\NC(from `a' and `y')\hfil\NC\NR
+\NC authornum\NC  \cite[authornum][me]\NC(from `a' and `num')\hfil\NC\NR
 \NC data\NC        \vtop{\hsize .45\hsize \cite[data][me]}\NC The data content of the entry\hfil\NC\NR
 \stoptabulate
 
@@ -439,24 +438,40 @@ except for \type{extras}. The argument of `\type{extras}' is typeset
 at the end of the reference, but before a potential `\type{right}', so
 it can be used for e.g. page or chapter specifiers.
 
+\subsection{Invisible citations}
+
+\setup{nocite}
+
+This command registers the references in the argument list, but does
+not generate typeset material. It can be used to force certain entries
+from the database to appear in the typeset list of publications.
 
 \section{Placing the publication list}
 
-This is really simple: use \type{\completepublications} 
-or \type{\placepublications} at the location in your
-text where you want the publication list to appear. As is normal in
-\CONTEXT, \type{\placepublications} gives you a raw list, and
-\type{\completepublications} a list with a heading. The module uses
-the following defaults for the generated head:
+To typset the list of publications, use \type{\completepublications}
+or \type{\placepublications} at the location in your text where you
+want the publication list to appear. As is normal in \CONTEXT,  
+\type{\placepublications} gives you a raw list, and
+\type{\completepublications} a list with a heading. 
+
+
+The default for the publication list is to contain only the `locally'
+referenced items, so if you want to use your own heading instead of
+the default one, you most likely want to call
+\type{\placepublications} with an explicit criterium, like so:
 \starttyping
-\setupheadtext[en][\biblistname=References]
-\setupheadtext[nl][\biblistname=Literatuur]
-\setupheadtext[de][\biblistname=Literatur]
-\setupheadtext[it][\biblistname=Bibliografia]
-\setupheadtext[sl][\biblistname=Literatura]
-\setupheadtext[fr][\biblistname=Bibliographie]
+\placepublications[criterium=all]
 \stoptyping
 
+The module uses the following defaults for the generated head:
+\starttyping
+\setupheadtext[en][pubs=References]
+\setupheadtext[nl][pubs=Literatuur]
+\setupheadtext[de][pubs=Literatur]
+\setupheadtext[it][pubs=Bibliografia]
+\setupheadtext[sl][pubs=Literatura]
+\setupheadtext[fr][pubs=Bibliographie]
+\stoptyping
 These (or new ones) can be redefined as needed.
 
 \section{The bbl file}
@@ -548,8 +563,8 @@ differentiates between these.\NC\NR
 \NC\type{\day}\NC\tfx DAY \NC Date of publication (for a patent)\NC\NR
 \NC\type{\dayfiled}\NC\tfx DAYFILED\NC Filing date for a patent\NC\NR
 \NC\type{\doi}\NC\tfx DOI \NC Document Object Identifier\NC\NR
-\NC\type{\eprint}\NC\tfx EPRINT\NC E-print information\NC\NR
 \NC\type{\edition}\NC\tfx EDITION\NC The edition.\NC\NR
+\NC\type{\eprint}\NC\tfx EPRINT\NC E-print information\NC\NR
 \NC\type{\howpublished}\NC\tfx HOWPUBLISHED\NC \NC\NR
 \NC\type{\isbn}\NC\tfx ISNB\NC isbn number (for books)\NC\NR
 \NC\type{\issn}\NC\tfx ISSN\NC issn number (for journals)\NC\NR
@@ -558,7 +573,7 @@ differentiates between these.\NC\NR
 \NC\type{\keyword}\NC\tfx KEYWORD \NC just text (for use in indices).\NC\NR
 \NC\type{\keywords}\NC\tfx KEYWORDS \NC just text (for use in indices).\NC\NR
 \NC\type{\lang}\NC\tfx LANGUAGE \NC The language of the
-    current bibliographic record (ignored at the moment)\NC\NR 
+    current bibliographic record\NC\NR 
 \NC\type{\month}\NC\tfx MONTH\NC Month of publication\NC\NR
 \NC\type{\monthfiled}\NC\tfx MONTHFILED\NC Filing month for a patent\NC\NR
 \NC\type{\names}\NC\tfx NAMES\NC just text (for use in indices).\NC\NR
@@ -588,6 +603,16 @@ differentiates between these.\NC\NR
 \NC\type{\yearfiled}\NC\tfx YEARFILED\NC Filing year for a patent\NC\NR
 \stoptabulate
 
+When the \type{\lang} field's content is a full word instead of a
+two||letter code, correct processing depends on an auxiliary command
+\type{\setbiblanguage}, to be used like this:
+\starttyping
+\setbiblanguage{English}{en}
+\stoptyping
+The first argument is a literal \type{\lang} argument, the second
+argument has to be a two||letter language abbreviation understood by
+\CONTEXT. 
+
 Adding in one of your own fields is reasonably simple:
 
 \starttyping
@@ -656,7 +681,7 @@ point.
 
 \section{References}
 
-\placepublications
+\placepublications[criterium=all]
 
 \stopdocumentation
 
diff --git a/doc/fonts/hoekwater/koeieletters/koeieletters.rme b/doc/fonts/hoekwater/koeieletters/koeieletters.rme
new file mode 100644
index 000000000..4be11cce8
--- /dev/null
+++ b/doc/fonts/hoekwater/koeieletters/koeieletters.rme
@@ -0,0 +1,45 @@
+Remarks
+
+The Koeieletters font is copyrighted (2006) by Hans Hagen
+and Taco Hoekwater. The font is based on original drawings
+by Duane Bibby.
+
+The Koeieletters font is distributed under the Creative
+Commons Attribution No Derivative Works licence. A summary
+of this licence can be found at the bottom of this file. The
+complete version of the licence can be found at:
+
+    http://creativecommons.org/licenses/by-nd/2.5/legalcode
+
+The font is supported by ConTeXt and more information about
+its history, evolution and usage can be found in the manual
+at www.pragma-ade.com.
+
+==== http://creativecommons.org/licenses/by-nd/2.5/ ====
+
+Attribution-NoDerivs 2.5
+
+You are free:
+
+    * to copy, distribute, display, and perform the work
+    * to make commercial use of the work
+
+Under the following conditions:
+
+    Attribution: You must attribute the work in the manner
+    specified by the author or licensor.
+
+    Derivative Works: You may not alter, transform, or
+    build upon this work.
+
+    * For any reuse or distribution, you must make clear
+      to others the license terms of this work.
+    * 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.
+
+==== end of copy =======================================
+
+