Re: [Groff] refer, mom and inline references

[Peter Schaffter]

Robin --

I'm glad you spotted the problem with inserting parenthetical
references into text.

Originally, mom's refer handling allowed for complete
bibliography-style insertion of parenthetical references, which
necessitated the .REF_STYLE and .REF( ... .REF) macros.  When I
revamped the refer handling to pure MLA, these macros ceased to
be necessary (or even function properly) because the refer block
commands 'label' and 'bracket-label' proved better suited for
formatting parenthetical references and accumulating them for output
with .BIBLIOGRAPHY.

I neglected, however, to update the documentation--which oversight
you've now brought to my attention.

On Fri, Aug 09, 2013, Robin Haberkorn wrote:
> I have now found an ugly solution that works with -mom.

Your solution looks a bit complicated for the purpose.  A
demonstration of a simpler way to set up parenthetical references
follows.  The documentation will reflect this when I rewrite it.

At the top of your file,

  .R1
    label "(A.n|Q) ', ' D.y"
    bracket-label " (" ")\c" "" 
    join-authors ", and " ", " ", and "
    reverse A1
    sort A1Q1T1B1E1
    database <path to database>
  .R2

With this setup, references entered without a preceding .REF are
inserted into running text.  For example,

  end of sentence
  .[
  keywords
  .]
  \&. A new sentence.

will produce "end of sentence (author's last name, date). A new
sentence."

To add a page or page-range number

  end of sentence
  .[
  [ keywords
  .], p. 168)\c
  \&. A new sentence.

will produce "end of sentence (author's last name, date, p. 168). A
new sentence."

The '\c' is required.  The first line of text after references of
either sort are entered the same way as first lines of text after
footnotes and endnotes (see the documentation).

To generate a bibliography of the cited works,

  .BIBLIOGRAPHY
  .[
  $LIST$ 
  .]
  .BIBLIOGRAPHY off

is all that's required.  There's no need for an additional refer
block.

Hope this helps.

-- 
Peter Schaffter
http://www.schaffter.ca