'\" t
.\"     Title: GREGORIO
.\"    Author: Elie Roux
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: juin  4, 2007
.\"    Manual: [FIXME: manual]
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "GREGORIO" "1" "juin 4, 2007" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gregorio \- tool for gregorian chant typesetting
.SH "SYNOPSIS"
.HP \w'\fBgregorio\fR\ 'u
\fBgregorio\fR [\fB\-hvVWsSL\fR] [\fB\-o\ \fR\fB\fIfile\fR\fR] [\fB\-f\ \fR\fB\fIformat\fR\fR] [\fB\-F\ \fR\fB\fIformat\fR\fR] [\fB\-l\ \fR\fB\fIerror\-file\fR\fR] [\fB\fIfile\fR\fR]
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBgregorio\fR
command\&.
.PP
\fBgregorio\fR
is the software of the gregorio project, that comes with a lot of functionalities\&. The goal is to describe and typeset a gregorian chant score very simply\&. The
\fBgregorio\fR
command is there to read and write the formats handled by the Gregorio project\&. See FORMATS for details\&.
.SH "OPTIONS"
.PP
These programs follow the usual
GNU
command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&.
.PP
\fB\-h\fR
.RS 4
Show summary of options\&.
.RE
.PP
\fB\-V\fR
.RS 4
Show version of program\&.
.RE
.PP
\fB\-L\fR
.RS 4
Show licence of program\&.
.RE
.PP
\fB\-v\fR
.RS 4
Set the program in verbose mode\&.
.RE
.PP
\fB\-W\fR
.RS 4
Show all warnings\&.
.RE
.PP
\fB\-s\fR
.RS 4
Read stdin as input\&.
.RE
.PP
\fB\-S\fR
.RS 4
Write output to stdout\&.
.RE
.PP
\fB\-F \fR\fIformat\fR
.RS 4
Sets the format of the produced file, where format is one of gabc, xml, otex, gtex, dump\&. See FORMATS for details\&. Default is gtex\&.
.RE
.PP
\fB\-f \fR\fIformat\fR
.RS 4
Sets the format of the file to read, where format is one of gabc, xml\&. See FORMATS for details\&. Default it gabc\&.
.RE
.SH "FORMATS"
.PP
\fBgabc\fR
.RS 4
Gregorian abc\&. The most interesting part of the Gregorio project, it is a very simple language made to describe briefly and simply a gregorian chant score\&. The syntax is quite close to abc language\&.
.RE
.PP
\fBxml\fR
.RS 4
GregorioXML is a XML language describing a gregorian chant score\&.
.RE
.PP
\fBgtex\fR
.RS 4
GregorioTeX is the TeX style made by the Gregorio project\&. You must install the
\fBgregoriotex\fR
environment to use it (it usually comes with gregorio)\&.
.RE
.PP
\fBotex\fR
.RS 4
OpusTeX is the most used TeX style to typeset a gregorian chant score\&. Install the
\fBopustex\fR
environment to use it\&.
.RE
.PP
\fBdump\fR
.RS 4
This output simply dumps the internal
\fBgregorio\fR
structure\&. Only for debugging\&.
.RE
.SH "EXAMPLE"
.PP
\fBgregorio myfile\&.gabc\fR
.RS 4
converts the gabc file into GregorioTeX, and writes the result to
\fBmyfile\&.tex\fR\&.
.RE
.SH "SEE ALSO"
.PP
http://home\&.gna\&.org/gregorio for a complete description of the formats\&.
.SH "AUTHOR"
.PP
\fBElie Roux\fR
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2007 Elie Roux
.br