piktf

piktf is a utility for finding elements within the PIKT configuration.  It takes the following command-line arguments:

Usage:  piktf [options] [<regexp>]

      Options:
        -i              do case insensitive matches
        -l              do literal matches, ignoring special regexp chars
        -f              list only matching .cfg, .alt, .obj,
                          or prgdir files
        -C              list only files in the configs directory
        -c              print count of matching lines
        -n              print line number of matching lines
        -p              match filenames, not files content
        -V              show version info
        -G              debug mode
        -T              test mode
        -h              help

        note : with -n, all matches are reported for a file.
               without -n, matching files are reported once.
               -n, -c and -p are mutually exclusive.

The -i option says to do case-insensitive matches on the given regular expression.

The -l option does literal matches, suppressing the special effect of characters such as *, +, ., and so on.

The -f option shows only the "official" PIKT configuration files ending with the .cfg, .alt, or .obj extensions, also any files in the programs directory (where there is no way we can predict file extensions, if any).  The -f option has the effect, therefore, of not showing files with extensions such as, .bak, .piktbak, and ~ (Emacs backup files), for example.

The -C option lists only files in the PIKT configs directory, thereby excluding files in the alerts, objects, programs, and other directories.  The -C option will therefore only tend to show .cfg files.

The -c option will print the files containing the <regexp>, also the total count of matching lines.

The -n option will print the files containing the <regexp>, also the line numbers of matching lines.

The -p option will search for <regexp> among the file names, not within the files themselves.

The -V option shows the version number.

Currently, the '-G' & '-T' options have no real effect.  They are there just for consistency.

The -h option shows program help (shown above).

piktf is especially useful if your PIKT setup is big and complex, and you have modularized your PIKT setup into many different #include files scattered among many different subdirectories.

Unlike many of the other PIKT binaries (which are written using a combination of C, lex, and yacc), piktf (like pikth, piktx & rkey) is written in Perl.

prev page

1st page

next page