PGN-EXTRACT(1)						      General Commands Manual						    PGN-EXTRACT(1)

NAME

       pgn-extract - a Portable Game Notation (PGN) extractor

SYNOPSIS

       pgn-extract [flags] file.pgn [file.pgn ...]

DESCRIPTION

       This  manual  page  briefly documents pgn-extract.  This manual page was written for the Debian GNU/Linux distribution because the original
       program does not have a manual page.

OPTIONS

       -7	   Output the seven tag roster for each game. Other tags, apart from FEN and possible ECo/Opening/Variation) are lost.

       -aoutputfile
		   The file to which extracted games are to be appended. See -o flag for overwriting an existing file.

       -Aargsfile  Read the program's arguments from argsfile.

       -b[elu]num  Restricted bounds on the number of moves in a game; lnum set a lower bound of `num' moves, unum set an  upper  bound  of  `num'
		   moves, otherwise num (or enum) means equal-to `num' moves.

       -cfile[.pgn]
		   Use file as a list of check files for duplicates.

       -C	   Don't include comments in the output. Ordinarily these are retained.

       -dduplicatefile
		   The file to which duplicate extracted games are to be written.

       -D	   Don't output duplicate extracted game scores.

       -eECO_file  Perform  ECO  classification  of  games. The optional ECO_file should contain a PGN format list of ECO lines. Default is to use
		   /usr/share/pgn-extract/eco.pgn as ECO_file.

       -E[123]	   Split output into separate files according to ECO. E1: Produce files from ECO letter, A.pgn, B.pgn, etc. E2: Produce files from
		   ECO	letter and first digit, A0.pgn, etc.  E3: Produce files from full ECO code, A00.pgn, A01.pgn, etc. All files are opened in
		   append mode.

       -ffile_list The file file_list contains the list of PGN files to be searched - one per line.

       -F	   Output a FEN string comment of the final game position.

       -h	   Print an abbreviated list of help.

       -h1	   Print further help.

       -?	   Print an abbreviated list of help.

       -llogfile   Create a new logfile for the diagnostics rather than using stderr.

       -Llogfile   Append all diagnostics to logfile rather than using stderr.

       -noutputfile
		   Write all valid games not otherwise output to outputfile.

       -N	   Don't include NAGs in the output. Ordinarily these are retained.

       -ooutputfile
		   The file to which extracted games are to be written.  Any existing contents of the file are lost (see -a flag).

       -P	   Don't match permutations of the textual variations (-v).

       -r	   Report any errors but don't extract.

       -Rtagorder  Use the tag ordering specified in the file tagorder.

       -s	   Silent mode don't report each game as it is extracted.

       -S	   Use a simple soundex algorithm for tag matches. If used, this option must precede the -t or -T options.

       -ttagfile   File of player, date, or result, extraction criteria.

       -Tcriterion Player, date, or result, extraction criteria.

       -U	   Don't output games that only occur once. (Use with -d to identify duplicates in multiple files.)

       -vvariations
		   The file variations contains the textual lines of interest.

       -V	   Don't include variations in the output. Ordinarily these are retained.

       -wwidth	   Set width as an approximate line width for output.

       -W	   Don't rewrite the moves into Standard Algebraic Notation.

       -W[cm|epd|san|elalg|lalg|halg]
		   Specify the output format to use. Default is san: standard algebraic notation.  cm is ChessMaster format. epd  is  EPD  format.
		   lalg  is  long algebraic.  halg is hyphenated long algebraic. elalg is enhanced long algebraic.  Use -Wsan[PNBRQK] for language
		   specific output, e.g., use -WsanBSLTDK for German. Similarly for -Welalg[PNBRQK].

       -xvariations
		   The file variations contains the lines resulting in positions of interest.

       -zendings   The file endings contains the end positions of interest.

       -Z	   Use the file virtual.tmp as an external hash table for duplicates.  Use when MallocOrDie messages occur with big datasets.

       -#num	   Output num games per file, to files named 1.pgn, 2.pgn, etc.

AUTHOR

       Pgn-extract was written by David Barnes <D.J.Barnes@ukc.ac.uk>.	This manual page was written by Peter van Rossum <petervr@debian.org>, for
       the Debian GNU/Linux system.

								  March 11, 2001						    PGN-EXTRACT(1)