
=head1 NAME 

=head2 conjug - Conjugation of Portuguese verbs

=head1 DESCRIPTION

   conjug [qvrcsx] verb+, [tense]*, [1-6]*

 - tense is one of 
      pres    Presente, 
      perf    Perfeito, 
      imp     Imperfeito, 
      fut     Futuro,
      mdp     Mais-que-Perfeito,
      cpres   Conjuntivo Presente,
      cimp    Conjuntivo Imperfeito,
      cfut    Conjuntivo Futuro,
      ivo     Imperativo
      pp      Partic'ipio Passado
      grd     Gerundivo 
      default is all.  
 
 - the numbers 1-4,6 correspond to
    "eu","tu","ele"/"ela","nos","eles"/"elas". 
    Second person plural is discarded.
    Default is all persons that apply to the tense.

  Returns the verb congugated at the requested tenses and persons as
  list of strings (one combination of tense, person each), one tense
  per row, one person per column, writing out, and a little more
  information : Typical output is :

      > conjug ouvir i pres cpres ivo pp grd
      ouvir :  irreg                                         
      pres     oi\co   ouves    ouve    ouvimos     ouvem    
      cpres    oi\ca   oi\cas   oi\ca   oi\camos    oi\cam   
      ivo              ouve     oi\ca   oi\camos    oi\cam   
      pp       ouvido                                        
      grd      ouvindo                                  

  Options

=over 4

=item  h

   Print this Help, then exit.

=item  q

   Quiet : Print only conjugated forms, with no extra stuff (see
         EXAMPLES). 

=item i

   Don't use Iso-8859-1 character set, but "^a"etc accents and
         "\c" cedilla.

=item  r

   Produce output as one person per Row, rather than the default
         one tense per row.

=item  x

   Each verb entry is a regular eXpression that matches a
         correct form.

=back

=head2 

  ACCENTUATION / CEDILLA : by default, the output uses iso-accents.

  C-CEDILLA is written \c

  ACCENTS are written sharp : 'a,  grave : `a, circumflex : ^o etc. 


=head2 EXAMPLES :

etienne@anonimo: conjug i ouvir pres
ouvir :  irreg                          
pres     oi\co ouves ouve ouvimos ouvem 

etienne@anonimo: conjug i q ouvir pres
oi\co ouves ouve ouvimos ouvem 

etienne@anonimo: conjug i qx ouvir pres
o[iu]\co ouves ouve ouvimos ouvem 


=head2 BUGS : 

=over 4

=item Cedillas must be protected from shell escape : you must write 
  "conjug cal\\car"  or "conjug 'cal\car' if don't want your verb to
  become 'calcar'.

=item Options "ir" are interpreted as the verb "ir".

=item Second person plural is not defined (little used).

=back

=head1 FILES :

  I<verb.pt> contains an ascii "database" of irregular verbs, and is
  indispensable to the correct functioning of "conjug".  

=head1 SEE ALSO : treinar, Lingua::PT::Conjugate.pm.

=head1 VERSION 0.01

=head1 AUTHOR Etienne Grossmann, January 1998 [etienne@isr.ist.utl.pt] 
 
=cut


