NAME

metafy - Change the metasyntactic words in your text

SYNOPSIS

metafy [ --help ] [ --version ] [--force-random] [theme[/category]:]theme[I>category>] [ file ... ]

DESCRIPTION

metafy filters any metasyntactic word and replace them with words from any "Acme::MetaSyntactic" theme. This script works as a filter or directly modifies the files given on the command-line.

A few examples should make it easy to understand what it does and how it works:

Replace words from the "foo" theme by words from the "batman" theme:
```
    $ metafy foo:batman
    
```
Replace the French metasyntactic words by the classic English ones:
```
    $ metafy foo/fr:foo/en
    
```
Replace any word from the "batman" theme by a random one from the "donmartin" theme. The replacement will be different every time:
```
    $ metafy --force-random batman:donmartin
    
```
Replace words from a theme by words from the same theme (for example if you didn't like the first run):
```
   $ metafy batman
    
```
In other words, if "from" is not given, it's the same as "to".
Modify a bunch of files in-place:
```
    $ metafy --in-place foo:batman *.c
    
```
There is currently no way to create backup files (like perl's -i option allows).

Each word from the original theme is replaced by the same word of the target theme. However, if the target theme does not contain enough words to map to the words from the original theme used in the file, then the same words maybe used more than once. This may break programs!

The option --force-random will certainly break your stuff.

COMMAND-LINE OPTIONS

The following command-line options are available (and can all be abbreviated):

Metasyntactic options

--force-random: Compute the replacement for each word every time it's needed. This will definitely break any program!
--in-place: Force in-place edition

Informative options

The program will exit if any of these options is selected. However, these options can be combined.

--themes: Print the list of available themes.
--version: Print version information.
--help: Print a short help message.

AUTHOR

Philippe "BooK" Bruhat, "<book@cpan.org>".

COPYRIGHT

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.