|
6 | 6 | % |
7 | 7 |
|
8 | 8 | % My gripe list about the Python style files: |
9 | | -% * I want italics in verbatim environments (verbatim.sty?) |
| 9 | +% * I want italics in verbatim environments for variable |
| 10 | +% text (verbatim.sty?) |
10 | 11 | % * I hate escaping underscores (url.sty fixes this) |
11 | 12 |
|
12 | | -% Should these be added to the standard Python doc tools? (They'll be |
13 | | -% needed for my "Distributing Python Modules" guide, too.) |
| 13 | +% '\command' is for Distutils commands which, depending on your |
| 14 | +% perspective, are just arguments to the setup script, or sub- |
| 15 | +% commands of the setup script, or the classes that implement |
| 16 | +% each "command". |
14 | 17 | \newcommand{\command}[1]{\code{#1}} |
| 18 | + |
| 19 | +% '\option' is for Distutils options *in* the setup script. Command- |
| 20 | +% line options *to* the setup script are marked up in the usual |
| 21 | +% way, ie. with '\programopt' or '\longprogramopt' |
15 | 22 | \newcommand{\option}[1]{\textsf{\small{#1}}} |
| 23 | + |
| 24 | +% '\filevar' is for variable components of file/path names -- eg. |
| 25 | +% when you put 'prefix' in a pathname, you mark it up with |
| 26 | +% '\filevar' so that it still looks pathname-ish, but is |
| 27 | +% distinguished from the literal part of the path. Fred says |
| 28 | +% this can be accomplished just fine with '\var', but I violently |
| 29 | +% disagree. Pistols at dawn will sort this one out. |
16 | 30 | \newcommand{\filevar}[1]{{\textsl{\filenq{#1}}}} |
17 | | -\newcommand{\homefile}[1]{\file{\tilde/#1}} |
18 | | -\newcommand{\comingsoon}{\emph{Coming soon...}} |
| 31 | + |
19 | 32 | \def\package{\module} |
20 | 33 |
|
21 | | -% And how about these? Very handy for writing pathnames (tilde for |
22 | | -% Unix, backslash for DOS/Windows). |
23 | | -\renewcommand{\tilde}{\raisebox{-0.5ex}{\symbol{126}}} |
24 | | -\newcommand{\bslash}{\symbol{92}} % XXX only works in tt fonts! |
| 34 | +% These two are handy for writing pathnames for Unix and Windows |
| 35 | +% (respectively). I define my own macros because I'm a lazy typist. |
| 36 | +\renewcommand{\tilde}{\textasciitilde} |
| 37 | +\newcommand{\bslash}{\textbackslash} |
25 | 38 |
|
| 39 | +% Just while the code and docs are still under development. |
26 | 40 | \newcommand{\XXX}[1]{\textbf{**#1**}} |
0 commit comments