llf.1

   1 .Dd 2017-01-20
   2 .Dt LLF 1
   3 .Os
   4 .Sh NAME
   5 .Nm llf
   6 .Nd Reformat and beautify LaTeX
   7 .Sh SYNOPSIS
   8 .Nm
   9 .Oo
  10 .Fl c
  11 .Ar config-file-path
  12 .Oc
  13 .Sh DESCRIPTION
  14 .Nm
  15 reflows LaTeX from
  16 .Pa stdin
  17 to
  18 .Pa stdout
  19 similarly to
  20 .Xr fmt 1
  21 in a way that preserves semantic meaning.
  22 .Pp
  23 Parsing LaTeX is very difficult: BASIC interpreters have been written
  24 in LaTeX, and parsing is equivalent to evaluating. Therefore,
  25 .Nm
  26 cannot be accurately said to reformat LaTeX.  However, it reformats a
  27 grammar which is probably close enough to LaTeX for everyday use.
  28 .Sh FILES
  29 .Nm
  30 may be configured by the following files
  31 .Pq in order of descending preference :
  32 .Pp
  33 .Bl -bullet -compact
  34 .It
  35 .Ar config-file-path
  36 .Po if
  37 .Fl c
  38 is given
  39 .Pc
  40 .It
  41 .Pa ${XDG_CONFIG_HOME}/llf/llfrc.lua
  42 .It
  43 .Pa ${HOME}/.config/llf/llfrc.lua
  44 .It
  45 .Pa /usr/share/llf/llfrc.lua
  46 .El
  47 .Sh AUTHORS
  48 .An S. Gilles Aq Mt sgilles@math.umd.edu