.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH FILE2BRL "1" "February 2024" "liblouisutdml 2.12.0" "User Commands"
.SH NAME
file2brl \- Translate an xml or a text file into an embosser-ready braille file
.SH SYNOPSIS
.B file2brl
[\fI\,OPTION\/\fR] [\fI\,inputFile\/\fR] [\fI\,outputFile\/\fR]
.SH DESCRIPTION
Translate an xml, html or a text file into an embosser\-ready braille file.
This includes translation into grade two, if desired, mathematical
codes, etc. It also includes formatting according to a built\-in
style sheet which can be modified by the user.
.PP
If inputFile is not specified or '\-' input is taken from stdin. If outputFile
is not specified the output is sent to stdout.
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-v\fR, \fB\-\-version\fR
display version information and exit
.TP
\fB\-f\fR, \fB\-\-config\-file\fR
name a configuration file that specifies
how to do the translation
.TP
\fB\-b\fR, \fB\-\-backward\fR
backward translation
.TP
\fB\-r\fR, \fB\-\-reformat\fR
reformat a braille file
.TP
\fB\-T\fR, \fB\-\-text\fR
Treat as text even if xml
.TP
\fB\-t\fR, \fB\-\-html\fR
html document, not xhtml
.TP
\fB\-p\fR, \fB\-\-poorly\-formatted\fR
translate a poorly formatted file
.TP
\fB\-P\fR, \fB\-\-paragraph\-line\fR
treat each block of text ending in a newline
as a paragraph. If there are two newline characters
a blank line will be inserted before the next paragraph
.TP
\fB\-C\fR, \fB\-\-config\-setting\fR
specify particular configuration settings
They override any settings that are specified in a
config file
.TP
\fB\-w\fR  \fB\-\-writeable\-path\fR
path for temp files and log file
.TP
\fB\-l\fR, \fB\-\-log\-file\fR
write errors to file2brl.log instead of stderr
.SH AUTHOR
Written by John J. Boyer.
.SH "REPORTING BUGS"
Report bugs to <liblouis\-liblouisxml@freelists.org>.
.SH COPYRIGHT
Copyright \(co 2023 ViewPlus Technologies, Inc. and JJB Software, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B file2brl
is maintained as a Texinfo manual.  If the
.B info
and
.B file2brl
programs are properly installed at your site, the command
.IP
.B info liblouisutdml
.PP
should give you access to the complete manual.