namefix cli help

namefix.pl 4.0

I am negelecting cmd line no more.
cli mode is strictly WIP, options likely to change.
most options are implemented - but in need of testing.
have fun.

namefix-cli.pl -<shortoptions> <target>
namefix-cli.pl --<longoption1> --<longoption2> --<longoption3=value> <target>
namefix-cli.pl -<shortoptions> --<longoption1> --<longoption2=value> <target>

Main Options:

h	--h			short help list
	--help			Long Help list
	--help-mp3		Mp3 Help list
	--help-trunc		Truncate Help
	--help-enum		Enumerate Help
	--help-all		All help (Long list of options)

!	--rename		preform rename
	--ren			enable once you are happy with preview.
				Without this option namefix defaults to 
				preview mode.

	--undo			undo last rename

g	--clean			general cleanup (reccomend)

c	--case			Fix case
s	--spaces		Convert _ to Space Delimiter " "
o	--dots			Dots "." to Space Delimiter " "
	--regexp		Enable regexp in remove option

	--remove=STRING		Remove STRING from filename
	--rm=STRING

	--replace=STRING	Replace removed string with STRING
	--rp=STRING		This option will be disabled
				if remove is not invoked

	--append-front=STRING	Append STRING to the start of filename
	--af=STRING

	--append-end=STRING	Append STRING to the end of filename
	--ae=STRING

C	--case-sp		Use special Casing list:
				/home/mem/.namefix.pl/list_special_word_casing.txt

R	--rm-words		Remove Custom Words list
				/home/mem/.namefix.pl/list_rm_words.txt

P	--rm-pat		Remove Custom regexp patterns, ie urls
				/home/mem/.namefix.pl/list_rm_patterns.txt

F	--fs-fix		Work around case insensitive filesystems
				eg microsofts fat32

Truncate Options:

	--trunc=N		truncate filenames to N length
	--trunc-pat=N		Select truncate pattern
				0 = Truncate from Start (Default)
				1 = Truncate from Middle
				2 = Truncate from End

	--trunc-ins=STRING	When using --trunc-pat=1
				Insert STRING in middle of filename
Enumerate Options:

	--enum			enumerate filenames
	--enum-style=N		Select enumeration method
				0 = Numbers Only (removes filename)
				1 = Insert at start of filename (Default)
				2 = Insert at end of filename.

	--enum-zero-pad=N	N = Pad enum number to N zeros
Misc Options:

i	--int			convert international characters to
				english equivalent

	--scene			Scenify Season and Episode Numbers
	--sc

	--unscene		Scenify Season and Episode Numbers
	--usc

U	--uc			uppercase all letters of filename
L	--lc			lowercase all letters of filename

	--rm-nc			remove nasty characters
	--rmc

	--rm-starting-digits	remove all digits from start of filename
	--rsd

	--rm-all-digits		remove all digits from filename
	--rad			Excluding file extension

H	--pad-hyphen		pad / hyphen dashes with space delimiter " "
	--ph

N	--pad-num		pad digits with -
	--pn			Aimed at track & EpisodexSeason numbers
				eg: "Artist 10 Title.mp3" to
				"Artist - 10 - Title.mp3"

0	--pad-num-w0		Pad numbers with zero's
	--p0			eg: track & EpisodexSeason numbers
				2x12 to 02x12, 3x4 to 03x05 etc

	--pad-nnnn-wx		Pad SeasonEpisode numbers with x
	--px			before: Show 0104 Episode title.avi
				after : Show 01x04 Episode title.avi
Advanced Options:

	--save-options		Save current options as default
	--save-opt		config file is located at:
				/home/mem/.namefix.pl/config.ini

	--recr			Recursive mode
				Warning: Use with caution

D	--dir			process directories
				Warning: Use with caution

	--overwrite		Preform rename without checking if new filename exists.
				Please be carefull witht this option

A	--all-files		Process all files, not just media files.

	--filt=STRING		Filter files processed. must contain STRING
	--filt-regexp		filter STRING is a regexp

	--space-char=C		C = Space Delimiter character
	--spc=C			Override default space delimiter " "
				and use C

	--media-types=STRING	only process the file extensions listed in STRING
	--mt=STRING		STRING format: "<file_ext1>|<file_ext2>"
				Default file types processed:
				jpeg|jpg|mp3|mpc|mpg|mpeg|avi|asf|wmf|wmv|ogg|ogm|rm|rmvb|mkv
Hacks:

	--html			output is formatted as html
				Then viewed in a console mode browser:
				elinks

	--browser		set browser to use for html hack
Documentation Options

	--help

	--changelog		prints out entire changelog
	--about			prints about info
	--todo			prints namefix.pl's todo list
	--thanks		Credit / Thankyou list of contributors.
	--links			Reccomend Links from the author
Debug Options:

	--debug=N		Set debug level to N (0-10)
	--debug-stdout		Print debug log to stdout
MP3 Options

	--id3-guess		guess mp3 tags from filename
	--id3-overwrite		overwrite existing id3 tags
	--id3-rm-v1		remove v1 id3 tags
	--id3-rm-v2		remove v2 id3 tags
	--id3-art=STRING	Set id3 artist tag to STRING
	--id3-tit=STRING	Set id3 title tag to STRING
	--id3-tra=STRING	Set id3 track tag to STRING
	--id3-alb=STRING	Set id3 album tag to STRING
	--id3-yer=STRING	Set id3 year tag to STRING
	--id3-com=STRING	Set id3 comment tag to STRING