On 15/05/10 03:26, Tom Lane wrote: > Russell Smith <mr-r...@pws.com.au> writes: > >>> By the operation of other items (-C --data-only) passed with -l, it only >>> produces to contents that would be restored with the other switches >>> provided. If that's expect behavior, then the documentation of the >>> switch is incorrect and should read something more like >>> >>> -l >>> --list List the items in the archive that would be restored >>> taking into account any other switches provided. The output of this >>> operation can be used with the -L option to further restrict and >>> reorder the items that are restored. >>> > Yeah, -l is limited by other filtering switches, and this definitely > ought to be stated more clearly in the documentation. (The content > of the produced file implies it, since it says *Selected* TOC Entries, > but that's hardly clear enough.) > > >> Further to these comments, both scenarios should make -l or -L >> incompatibe with -C --data-only -I -n --schema-only -T -t -x as all >> these alter the contents of what is restored. You should either use the >> list to control the items restored or the switches. Using both just >> created confusion. >> > I believe that allowing the filter switches to act on -l is a useful > behavior, and anyway it's been like that for many years and nobody's > complained before. So I'm not excited about taking out the > functionality. > > However, I think -C is a special case because it's quite un-obvious > to the user that it effectively acts as a filter switch --- in fact a > de-filtering switch, because the lack of -C is what filters out the > DATABASE item. > > I'm inclined to think that we should document that the output of -l > is restricted by -n and similar switches, but change the code so that > -C doesn't affect -l output. Comments? > Sounds good. -L could do with some man page help as well;
--use-list=list-file Restore elements in list-file only, and in the order they appear in the file. Lines can be moved and can also be commented out by placing a ; at the start of the line. (See below for examples.) That indicates that "list-file only" lacks clarity when you can further restrict with command line parameters. Thanks Russell -- Sent via pgsql-bugs mailing list (pgsql-bugs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-bugs