Many hyperlinks are disabled.
Use anonymous login
to enable hyperlinks.
Overview
Comment: | More editorial work. |
---|---|
Downloads: | Tarball | ZIP archive |
Timelines: | family | ancestors | descendants | both | glob-docs |
Files: | files | file ages | folders |
SHA3-256: |
1adc47e0ef0c3c46fac88eb824204b36 |
User & Date: | rberteig 2017-04-18 19:50:11.336 |
Context
2017-04-18
| ||
22:25 | In globs.md, fixed one more all-caps GLOB and reworded some things. ... (check-in: daf2ada2 user: rberteig tags: glob-docs) | |
19:50 | More editorial work. ... (check-in: 1adc47e0 user: rberteig tags: glob-docs) | |
01:29 | Substantial and minor changes to the file globs document taking advice from Warren Young's email. ... (check-in: 1239b6c4 user: rberteig tags: glob-docs) | |
Changes
Changes to www/globs.md.
|
| | | | > > | | | | | | < | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 | # File Name Glob Patterns A [glob pattern][glob] is a text expression that matches one or more file names using wild cards familiar to most users of a command line. For example, `*` is a glob that matches any name at all and `Readme.txt` is a glob that matches exactly one file. Note that although both are notations for describing patterns in text, glob patterns are not the same thing as a [regular expression or regexp][regexp]. [glob]: https://en.wikipedia.org/wiki/Glob_(programming) (Wikipedia) [regexp]: https://en.wikipedia.org/wiki/Regular_expression A number of fossil setting values hold one or more file glob patterns that will identify files needing special treatment. Glob patterns are also accepted in options to certain commands as well as query parameters to certain pages. In many cases more than one glob may be specified in a setting, option, or query parameter by listing multiple globs separated by a comma or white space. Of course, many fossil commands also accept lists of files to act on, and those also may be specified with globs. Although those glob patterns are similar to what is described here, they are not defined by fossil, but rather by the conventions of the operating system in use. |
︙ | ︙ | |||
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 | [^...] Matches one character not in the enclosed list. Special character sequences have some additional features: * A range of characters may be specified with `-`, so `[a-d]` matches exactly the same characters as `[abcd]`. Ranges reflect Unicode code points without any locale-specific collation sequence. * Include `-` in a list by placing it last, just before the `]`. * Include `]` in a list by making the first character after the `[` or `[^`. At any other place, `]` ends the list. * Include `^` in a list by placing anywhere except first after the `[`. * Some examples of character lists: `[a-d]` Matches any one of `a`, `b`, `c`, or `d` but not `ä`; `[^a-d]` Matches exactly one character other than `a`, `b`, `c`, or `d`; `[0-9a-fA-F]` Matches exactly one hexadecimal digit; `[a-]` Matches either `a` or `-`; `[][]` Matches either `]` or `[`; `[^]]` Matches exactly one character other than `]`; `[]^]` Matches either `]` or `^`; and `[^-]` Matches exactly one character other than `-`. | > > > > > | > | > | 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | [^...] Matches one character not in the enclosed list. Special character sequences have some additional features: * A range of characters may be specified with `-`, so `[a-d]` matches exactly the same characters as `[abcd]`. Ranges reflect Unicode code points without any locale-specific collation sequence. * Include `-` in a list by placing it last, just before the `]`. * Include `]` in a list by making the first character after the `[` or `[^`. At any other place, `]` ends the list. * Include `^` in a list by placing anywhere except first after the `[`. * Some examples of character lists: `[a-d]` Matches any one of `a`, `b`, `c`, or `d` but not `ä`; `[^a-d]` Matches exactly one character other than `a`, `b`, `c`, or `d`; `[0-9a-fA-F]` Matches exactly one hexadecimal digit; `[a-]` Matches either `a` or `-`; `[][]` Matches either `]` or `[`; `[^]]` Matches exactly one character other than `]`; `[]^]` Matches either `]` or `^`; and `[^-]` Matches exactly one character other than `-`. Beware that ranges in lists may include more than you expect: `[A-z]` Matches `A` and `Z`, but also matches `a` and some less obvious characters such as `[`, `\`, and `]` with code point values between `Z` and `a`. Beware that a range must be specified from low value to high value: `[z-a]` does not match any character at all, preventing the entire glob from matching. * Note that unlike typical Unix shell globs, wildcards (`*`, `?`, and character lists) are allowed to match `/` directory separators as well as the initial `.` in the name of a hidden file or directory. White space means the ASCII characters TAB, LF, VT, FF, CR, and SPACE. |
︙ | ︙ | |||
179 180 181 182 183 184 185 | ### Commands that Refer to Globs Many of the commands that respect the settings containing globs have options to override some or all of the settings. These options are usually named to correspond to the setting they override, such as `--ignore` to override the `ignore-glob` setting. These commands are: | | | | | | | | | | | | | | | > > > > > > > > > > > | > > > > | > | < < > > > > > > | | | | > > > > | 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 | ### Commands that Refer to Globs Many of the commands that respect the settings containing globs have options to override some or all of the settings. These options are usually named to correspond to the setting they override, such as `--ignore` to override the `ignore-glob` setting. These commands are: * [`add`][] * [`addremove`][] * [`changes`][] * [`clean`][] * [`extras`][] * [`merge`][] * [`settings`][] * [`status`][] * [`unset`][] The commands [`tarball`][] and [`zip`][] produce compressed archives of a specific checkin. They may be further restricted by options that specify glob patterns that name files to include or exclude rather than archiving the entire checkin. The commands [`http`][], [`cgi`][], [`server`][], and [`ui`][] that implement or support with web servers provide a mechanism to name some files to serve with static content where a list of glob patterns specifies what content may be served. [`add`]: /help?cmd=add [`addremove`]: /help?cmd=addremove [`changes`]: /help?cmd=changes [`clean`]: /help?cmd=clean [`extras`]: /help?cmd=extras [`merge`]: /help?cmd=merge [`settings`]: /help?cmd=settings [`status`]: /help?cmd=status [`unset`]: /help?cmd=unset [`tarball`]: /help?cmd=tarball [`zip`]: /help?cmd=zip [`http`]: /help?cmd=http [`cgi`]: /help?cmd=cgi [`server`]: /help?cmd=server [`ui`]: /help?cmd=ui ### Web Pages that Refer to Globs The [`/timeline`][] page supports the query parameter `chng=GLOBLIST` that names a list of glob patterns defining which files to focus the timeline on. It also has the query parameters `t=TAG` and `r=TAG` that names a tag to focus on, which can be configured with `ms=STYLE` to use a glob pattern to match tag names instead of the default exact match or a couple of other comparison styles. The pages [`/tarball`][] and [`/zip`][] generate compressed archives of a specific checkin. They may be further restricted by query parameters that specify GLOBs that name files to include or exclude rather than taking the entire checkin. [`/timeline`]: /help?cmd=/timeline [`/tarball`]: /help?cmd=/tarball [`/zip`]: /help?cmd=/zip ## Platform quirks The versioned settings files have no platform-specific quirks. Any GLOBs that matter to your workflow belong there where they can be safely edited. |
︙ | ︙ |
Changes to www/mkindex.tcl.
︙ | ︙ | |||
34 35 36 37 38 39 40 | event.wiki {Events} faq.wiki {Frequently Asked Questions} fileformat.wiki {Fossil File Format} fiveminutes.wiki {Up and Running in 5 Minutes as a Single User} foss-cklist.wiki {Checklist For Successful Open-Source Projects} fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE} fossil-v-git.wiki {Fossil Versus Git} | | | 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 | event.wiki {Events} faq.wiki {Frequently Asked Questions} fileformat.wiki {Fossil File Format} fiveminutes.wiki {Up and Running in 5 Minutes as a Single User} foss-cklist.wiki {Checklist For Successful Open-Source Projects} fossil-from-msvc.wiki {Integrating Fossil in the Microsoft Express 2010 IDE} fossil-v-git.wiki {Fossil Versus Git} globs.md {File Name Glob Patterns} hacker-howto.wiki {Hacker How-To} hashpolicy.wiki {Hash Policy: Choosing Between SHA1 and SHA3-256} /help {Lists of Commands and Webpages} hints.wiki {Fossil Tips And Usage Hints} index.wiki {Home Page} inout.wiki {Import And Export To And From Git} makefile.wiki {The Fossil Build Process} |
︙ | ︙ |