Re: [Groff] help with mom bibliography

[Peter Schaffter]

Anton --

On Thu, Sep 06, 2012, Anton Shterenlikht wrote:
> I'm just starting with mom.
> I'm surely doing something wrong.
> Please help
> 
> .TITLE "the title"
> .AUTHOR "the author"
> .PP
> Here's Fokion's thesis
> .[
> oikonomidis
> .]
> .BIBLIOGRAPHY
> .R1
> no-label-in-text
> no-label-in-reference
> join-authors ", and " ", " ", and "
> sort A1Q1T1B1E1
> reverse A1
> database /home/mexas/work/Ind
> .R2 
> .[
> $LIST$
> .]
> .BIBLIOGRAPHY OFF

First things first.  You must supply a PRINTSTYLE directive and
issue the START command before any document processing begins (see
my example, below).

Now, all the stuff that can get a tad confusing.

If you're citing a work in the body of a document, as you do in
your sample, you need to say whether the work cited should appear
in the endnotes, or as a footnote.  Thus either FOOTNOTE_REFS or
ENDNOTES_REFS needs to appear somewhere before the first citation
(see example).  I'll assume you want endnotes.  In either case, you
must put this refer block at the top of your input file:

.R1
no-label-in-text
no-label-in-reference
join-authors " and " ", " ", and "
database <full path to database>
.R2

Secondly, the having established that you want endnotes references,
the refer commands .[ and .] need themselves to be surrounded by
REF, like this:

  .REF
  .[
  keyword
  .]
  .REF

In addition, since a marker will be placed in the text (in the case
of endnotes, a superscript number), you must append \c to the end of
the line immediately before the first REF, and continue the text
that comes after the second REF exactly as if there'd been no
interruption in the input, eg

  some text\c
  .REF
  .[
  keyword
  .]
  .REF
  , which continues here

Lastly, references created this way are output with the ENDNOTES
macro, not BIBLIOGRAPHY.

If you want a bibliography, which is usually a complete,
alphabetically-sorted list of consulted works or a suggested reading
list, you must state which works go in the bibliography before
issuing the $LIST$ command, eg.

.BIBLIOGRAPHY
.R1
no-label-in-text
no-label-in-reference
join-authors ", and " ", " ", and "
sort A1Q1T1B1E1
reverse A1
database <full path to database>
.R2 
.[
keyword
.]
.[
$LIST$
.]
.BIBLIOGRAPHY OFF

It's possible to have both endnotes and a bibliography, as the
examples show.

---refer database---

%A Firstname Lastname
%T Book Title
%D 2012
%C City
%I Publisher
%P 187
%k oikonomidis

%A Firstname Lastname
%T Book Title
%D 2012
%C City
%I Publisher
%k oikonomidis-bib

---example file---

.R1
no-label-in-text
no-label-in-reference
join-authors " and " ", " ", and "
database /home/peter/Groff-mom/Testing/Anton/database
.R2
.TITLE "Test document"
.AUTHOR "Author"
.PRINTSTYLE TYPESET
.ENDNOTE_REFS
.BIBLIOGRAPHY_TYPE PLAIN
.START
.PP
Here's Fokion's thesis\c
.REF
.[
oikonomidis
.]
.REF
 lorem ipsum dolor sit amet, consectetur adipiscing elit.  Sed at
ante.  Mauris eleifend, quam a vulputate dictum, massa quam dapibus
leo, eget vulputate orci purus ut lorem.
.ENDNOTES
.BIBLIOGRAPHY
.R1
no-label-in-text
no-label-in-reference
join-authors ", and " ", " ", and "
sort A1Q1T1B1E1
reverse A1
database /home/peter/Groff-mom/Testing/Anton/database
.R2
.[
oikonomidis-bib
.]
.[
$LIST$
.]
.BIBLIOGRAPHY OFF

MLA style has different style rules for Works Cited (ie endnotes)
and bibliographies.  I'm attaching a .pdf of the output so you can
see how mom reformats the same data depending on whether she's doing
endnotes or a bibliography.

There's a small bug in mom 2.0 that sometimes prevents printing of
the final period after page number(s) at the end of a reference.
It's fixed in the CVS and in the mom tarball at

  http://www.schaffter.ca/mom/mom-2.0.tar.gz

-- 
Peter Schaffter

Author of The Binbrook Caucus
http://www.schaffter.ca