Debian Codegraph @

CHANGES

raw
1 #############################################################################
2 # CHANGE LOG
3 #############################################################################
4
5 VERSION 1.12
6 x Added a copyright statement at the request of a Debian administrator.
7 https://rt.cpan.org/Public/Bug/Display.html?id=62017
8
9 VERSION 1.11
10 x Added prefixadmin to the MANIFEST
11
12 VERSION 1.1
13 x Supports the "secure" option attribute. (Also, all options which end in "pass" or "password"
14 are assumed to be secure.) The value is a security level: 1=[don't print the value in a help screen].
15 2=[ensure that the value can never be supplied on a command line or from the environment but
16 only from a file that only the user running the program has read/write access to]
17
18 VERSION 1.07
19 x Automagically add $PREFIX/lib/perl5 to @INC (only if it exists), else $PREFIX/lib/perl
20 Also check $PREFIX/share/perl and add it to @INC if it exists.
21 Surprisingly, $PREFIX/share/perl and $PREFIX/lib/perl seem to be the directories created
22 and used under Ubuntu 8.04's perl.
23 x Allow dashes ("-") as a variable name (i.e. foo-bar = 1).
24 In doing this, I actually allow that any characters other than spaces/tabs/= can make up the variable name
25 x Trim leading and trailing tabs (as well as spaces) from the line
26
27 VERSION 1.06
28 x Remove trailing \r from option files (for Windows-edited .conf files)
29
30 VERSION 1.05
31 x Substitutions of ${prefix} in option files now works even if only defined by assumption
32 This is particularly valuable for portability between environments of CGI scripts and cron scripts.
33
34 VERSION 1.04
35 x Fixed RT Bug #33597: Problem of ignoring drive letter on Win32 filesystem.
36
37 VERSION 1.03
38 x better use of /\s*/ instead of / */ so that tabs don't catch you off-guard
39 x enable application use of App::Options objects to read additional data structures
40 * $option_processor = App::Options->new(@args);
41 * $option_processor->read_option_files(\%values, [$file]);
42 x allow for subclassing (App::Options::YAML, etc.)
43 * made App::Options object-oriented to allow for subclassing
44 * split read_option_files() method out of the read_options() method (for subclassing)
45 x save the import arguments for later print_usage or later reparsing (as $self->{init_args})
46
47 VERSION 1.02
48 x ENV{FOO} = x in app.conf sets environment variable "FOO" (i.e. LD_LIBRARY_PATH)
49 x added perl_restart option to re-exec() the program so that it picks up a new LD_LIBRARY_PATH
50 x save original @ARGV to @App::Options::ARGV (used for perl_restart/re-exec())
51 x line continuation characters strip off newlines and leading spaces
52
53 VERSION 1.01
54 x removed dependency in Makefile.PL on Config.pm (which was causing a false error on "make test")
55
56 VERSION 1.00
57 x clean up for v1.00. no dependency on Module::Build (which has been giving problems)
58 x add default values for MANPATH, LD_LIBRARY_PATH to bin/prefix
59 x added t/file.txt so the test process doesn't spew warnings
60
61 VERSION 0.99
62 x fixed a condition that didn't work on Windows when executing in current dir
63 x fix double slash /usr/rubicon/test/bin//app.conf
64 x improved --debug_options, --debug_options=[1-7] output
65
66 VERSION 0.98
67 x disabled some tests that cause failure on MSWin32
68
69 VERSION 0.97
70 x enable "here documents", var = <<EOF
71 x enable file/cmd variables, var = < filename (or "cmd|")
72 x allow line continuation chars, i.e. var = hello \\nworld
73
74 VERSION 0.96
75 x cleaned up some of the --debug_options output
76 x tests run clean on Win32
77 x used File::Spec to make file/directory manipulation platform-independent (i.e. Win32)
78 NOTE: I used a mix of platform-independent File::Spec functions and explicit
79 conversion from "\" paths to POSIX-compliant "/" paths. This is because the
80 purist form of leaving "\" paths for Win32 was causing weirdness. When
81 I would interpolated the string or use it in a regular expression, the
82 backslashes were interacting badly. The only reason I'm not going to 1.0
83 with this is that I want to see it pass Win32 tests on the CPAN testers
84 farm before giving it that number.
85
86 VERSION 0.95
87 x made a change (hack) to Build.PL to get it to work with the CPAN shell
88
89 VERSION 0.94
90 x use Module::Build instead of ExtUtils::MakeMaker
91 x add a META.yaml file to the distribution (from "Build distmeta")
92 x add --version support (print out versions of all modules)
93 x make prefix authoritative before defaults so that we can use ${prefix} in substitutions
94 x set defaults in order of "options" to ensure the correct order for variable substitution
95
96 VERSION 0.93
97 x prefix can now be set in $prog_dir/app.conf to find $prefix/etc/app/app.conf
98 x single-line sections in option files are no longer independent of the
99 section they are in. Both the section-condition and the line-condition
100 must now be satisfied for a value to be set.
101
102 VERSION 0.92
103 x cleaned up some warnings which appeared under -w (concatenation of undef)
104 x add system-supplied hostname and host options
105 x variable substitution works with environment vars (url = http://$ENV{HOST})
106 x auto-import of environment vars named "APP_*" even if not otherwise defined
107 x usage: undefined values appear as "[undef]" rather than "[]"
108 x usage: options appear as "--var=<value>" rather than "--var=<var>"
109 x usage: "args_description" describes what's left on cmd line after options removed
110 x usage: "value_description" describes option value (instead of "<value>")
111 x added an examples directory
112 x added a benchmark directory
113 x default is $Config{prefix} instead of /usr/local
114 x improve debug_options (env vars, etc.) (implemented 6 levels of debug_options)
115
116 VERSION 0.91
117 x show_all is off by default whenever "option" or "options" used
118 x remove app_path_info
119
120 VERSION 0.90
121 x new "use App::Options (...);" syntax (rather than ->init(...) syntax)
122
123 VERSION 0.64
124 x added $VERSION to App::Options (use VERSION_FROM in Makefile.PL)
125 x fixed bug where "show_all" wasn't showing all on --help
126 x touched up titles on pod documentation
127 x implement import() method to use module outside the BEGIN block (i.e. use App::Options (@args))
128 x update documentation with new syntax using import() method
129 x improve show_all logic: show_all = 1 by default always unless overridden
130
131 VERSION 0.63
132 x improve documentation (api reference, logic flow, usage tutorial)
133 x "integer" type now matches integers with underscores (i.e. 1_000_000)
134 x "float" type now matches numbers with underscores (i.e. 1_000.000_001)
135 x added /etc/app/app.conf to the end of the option file search path
136 x default "prefix" is now "/usr/local" instead of "."
137 x {env} attribute of "" means don't search any env variable
138
139 VERSION 0.62
140 x [prog] matches "prog" only. [/prog/] matches by regular expression.
141 In version 0.61, the section [list] would match ($app =~ /list/).
142 In version 0.62, the section [list] only matches ($app eq "list"),
143 while [/list/] matches ($app =~ /list/).
144 x type="/regexp/" matches regexp. unknown types ignored.
145 In version 0.61, an option type which was not one of the known
146 option types (integer, float, date, datetime, etc.), was considered
147 automatically as a regular expression.
148 In version 0.62, only types which take the form "/regexp/" are
149 actually regular expressions. All other unknown "types" are ignored.
150 This sets the groundwork for better forward-compatibility when new
151 types are introduced, they will not break older versions of the code.
152 It also just seems clearer.
153 x "show_all" option - shows all defined options, not just in [ options ]
154 In version 0.61, the --help option would show all variables defined
155 in the code, on the command line, or in any of the files (i.e.show_all=1).
156 However, if the "options" argument is used in the init() method in the
157 code, only those enumerated options would be shown (i.e. show_all=0).
158 In version 0.62, the same behavior applies unless the "show_all"
159 parameter is given explicitly.
160 x quoting, var = " hello world "
161 In version 0.61, variable values in the option file had leading and
162 trailing spaces removed. This meant that a value of a single space
163 was not possible.
164 In version 0.62, the same behavior applies. However, if the
165 remaining text starts with " and ends with ", those quote marks are
166 removed. i.e. var = " " will result in the value of a single space,
167 and message = "Hello world. " will have a trailing space.
168 x check list of configurable environment vars ("env") instead of
169 "APP_${uc_var}"
170 In version 0.61, variable values could be supplied by specifying the
171 variable prefixed with "APP_". (i.e. "path" could be specified
172 with "APP_PATH")
173 In version 0.62, a list of environment variable names may be given
174 and the first with a supplied value is used for the value.
175 (i.e. options => { path => { env => "PATH" } } will cause the
176 "path" variable to be set from the "PATH" environment variable.)
177
178 VERSION 0.61
179 x Initial release
180