simplification and optimization of a main loop

this eliminates some needless data shuffling in a critical loop

added a .perltidyrc file

change -wvt=string to require space- or comma-separated vars

This will allow future option names which are more than 1 letter
Non-spaces (bundled) still work but produce a warning

update tutorial

The -DEBUG option no longer also writes a .LOG file

This was almost never needed and left a lot of files to clean up.

optimizations

update list of switches which may be negated

improve structure of manual

Too many commands were lumped into "Other Controls"

fix typo

remove unused vars located with -duv

avoid reused name

add 2 missing elses using -ame

write initializer for -wvt; remove unused vars found with -duv

remove some unused vars located with -duv

add example to docs

minor optimization of sub undo_ci

fix numerous issues in examples found with -duv

skip certain operations during iterations

simplify Die and Warn calls

improve error checking

fix typos, simplify wording

bump version to 20230912.11

fix issue where -nwcp without -wcp was not working

bump version to 20230912.10

split -wcp=s into -wcp=s and -nwcp=s to simplify use

warn about v-string and x-operator hash keys

consolidate duplicated hashes

add --dump-mixed-call-parens (-dmcp); bump version

bump version to 20230912.08

add option --want-call-parens=s, see git #128

fix c316: remove sub do_QUOTED_BAREWORD

minor code cleanups

reduce nesting depth, and convert all remaining @{word} to @word

update -duv to work better with v5.36 experimental for_list

update links, add section on vertical alignment

be sure Klast is undef if Kfirst is undef

not a bug, but could be confusing when code is updated

add section on list formatting

update docs

update comments

optimize -wvt

Run time is significantly reduced by skipping needless counting
Total run time with -wvt=1 now increases by <<1% vs without -wvt

improve code for finding unused vars in if-chains with -duv

add check for missing string parameter, c312

bump to 20230912.07

improve scan for unused vars

change dv to duv, wv to wvt=s

The old names were a little confusing because they were very similar but
one took an arg and the other did not.
  dump-variables     -> dump-unusual-variables  (dv->duv)
  warn-variables=s   -> warn-variable-types     (wv->wvt)

fix minor issues found with -wv

fix some minor issues found with -dv

update examples

exclude all dump- parameters from random testing

eliminate all issues identified with -wv

update docs

sort package error messages by line number

update docs

bump version to .06

update docs

add docs for -dv and -wv

minor changes to -dv and -wv options

near final coding of --warn-variables and --dump-variables

these work but still need documentation

cleanup -wvu code

add -wvuxl

clean up -wvu coding

update -wvu option

add -wvu

fix search for git home

add comment

remove unused call args

add utility blinkers.pl

remove unused code

fix b1463

do not use --show-options in random testing

add note to docs about word-wrapping comments (see git#127)

fix b1462

simplify logfile switches

add internal error checks

do not include -cti (an alias) among random parameters in testing

update comments

remove unused code; fix some comments

re-order some if tests for improved efficiency

this simple change in order saves 0.25% run time

simplify coding for 'this_batch'

revise sub set_vertical_tightness_flags

skip needless flush calls

simplify several split calls

bump version to .05

fix split

fix issue c302

add integer option range checks before processing

Previously, integer ranges were checked and fixed after processing started.

check for negative -i and -ci

more efficient data structures for token tree navigation, part 2

more efficient data structures for token tree navigation, part 1

This eliminates a lot of double indexing

check size of files arriving from stdin

use more efficient tokenizer checks for special cases

use more efficient check for negative levels

check for negative --starting-indentation-level

improve guessing rule for division vs pattern (c243)

perl counts a newline as a space when guessing

add internal tokenizer consistency check

optimization

update max_arguments

reformat some long arg lists

reformat some long arg lists

rewrite several arg lists as hashes for clarity

check for and warn on non-ascii characters in perltidy modules

These are undesirable. For example, even 1 non-ascii char forces a very slow
check for utf-8 every time perltidy reformats itself, which is often.