summaryrefslogtreecommitdiff
path: root/doc/input.but (follow)
Commit message (Collapse)AuthorAge
* Mention \s in a section title.Simon Tatham2016-01-22
| | | | | A user points out that that recently added markup feature is easy to miss because it's not as prominently documented as it should be.
* Remove Subversion expanded keywords everywhere.Simon Tatham2014-09-24
| | | | | | | | | | The \versionids in the docs are now added by the bob script; the one in inputs/test.but has been replaced by fixed text (it didn't matter what it contained anyway, of course, for test purposes), and the one in misc/halibut.vim has simply been removed (it wasn't actually expanded by svn anyway - it still had its old CVS value). [originally from svn r10253]
* Index term tweaks in manual for \s to quell warnings when building, etc.Jacob Nevins2013-03-23
| | | | [originally from svn r9774]
* Add \s for 'strong' text, i.e. bold rather than italics. I've missedSimon Tatham2013-03-10
| | | | | | | | | | | | | | this a couple of times in Halibut markup recently (in particular, it's handy to have a typographical distinction between 'this term is emphasised because it's new' and 'this term is emphasised because I want you to pay attention to it'), so here's an implementation, basically parallel to \e. One slight oddity is that strong text in headings will not be distinguished in some output formats, since they already use bolded text for their headings. [originally from svn r9772]
* Clarify the section about backend-generic config options to make itSimon Tatham2010-01-14
| | | | | | look less as if they're the _only_ config options. [originally from svn r8842]
* Use consistent capitalisation for HTML tags.Jacob Nevins2007-01-28
| | | | [originally from svn r7178]
* Introduce global (cross-backend) \cfg{contents} and \cfg{index}Simon Tatham2006-06-02
| | | | | | | commands, allowing the fixed words "Contents" and "Index" generated in various output formats to be reconfigured into other languages. [originally from svn r6724]
* Add a `--list-charsets' option to Halibut to enumerate canonical names of knownJacob Nevins2005-02-18
| | | | | | | | | character sets. (Also make libcharset `return_in_enum' values saner.) [originally from svn r5341] [this svn revision also touched charset,filter,timber]
* Add \versionid.Jacob Nevins2005-02-17
| | | | [originally from svn r5338]
* Changes/additions to input character set handling:Jacob Nevins2005-02-17
| | | | | | | | | | | | | | | | | - After discussion with Simon, change the default input charset back to ASCII, rather than trying to work it out from the locale, for the sake of promoting .but file portability. - Add a new command-line option "--input-charset=csname", which overrides the ASCII default for all input files (since there's no other way to use a non-ASCII-compatible input file). - Output a warning if -Cinput-charset:foo is specified that it has no effect. - Update the docs to match all this. Also try to clarify some other things in this area that caught me out. [originally from svn r5332]
* Explicitly bless in the documentation, and fix in the man backend,Simon Tatham2004-08-06
| | | | | | | the practice of using \dt and \dd in anything other than the obvious interleaving. [originally from svn r4417]
* Right; I'm finally sick of typing \q{\cw{foo}}, so I've invented aSimon Tatham2004-07-16
| | | | | | shorthand command \cq{foo}. [originally from svn r4327]
* Note that \cfg{quotes} and friends apply to the output in its entirety andJacob Nevins2004-06-19
| | | | | | can't be changed partway through. Also, add a cross-reference from \q{}. [originally from svn r4298]
* Initial rough documentation of some of the newer \cfg{} directives, namely:Jacob Nevins2004-06-19
| | | | | | | | | | | | - \cfg{quotes} - text, info, man, and winhelp backends: - charset - quotes and bullets - various WinHelp miscellanea Could stand some rearrangement and expansion, plus I've yet to address the paper or HTML backends. [originally from svn r4295]
* The Halibut manual contained at least one instance of two indexSimon Tatham2004-06-13
| | | | | | | | | | | | | | terms (intentionally) differing only in case, which were being silently folded into one by the case-insensitive index tag comparison. Halibut now warns in this situation (but then folds them anyway, which I think is better than silently generating an index containing many case-distinct forms of the same word - I imagine it's very easy to do that by mistake). The manual has been fixed to explicitly define distinct keywords (in the case I spotted and in five other cases picked up by the new warning!), and also documents this issue and how to work with it. [originally from svn r4279]
* Er, don't forget to document the disallowing of \q within \c. Ahem.Simon Tatham2004-06-12
| | | | [originally from svn r4278]
* Oh, and now the text backend warns about too-long code lines, I'dSimon Tatham2004-04-23
| | | | | | better remove the one too-long code line in the manual :-) [originally from svn r4129]
* Don't forget to mention the default setting for \cfg{input-charset}.Simon Tatham2004-04-20
| | | | [originally from svn r4106]
* Support for \cfg{input-charset}. Input files can now be in ASCII,Simon Tatham2004-04-19
| | | | | | | 8859-*, UTF-8, or a variety of more fun encodings including various multibyte ones. [originally from svn r4095]
* Support the \W{...}\i\c{...} combination used in the NASM manual.Simon Tatham2004-04-15
| | | | | | | | Halibut is now capable of reading the old NASM manual with only minor modifications, and probably doing a much better job of formatting it than rdsrc.pl ever did. (Certainly much _faster_!) [originally from svn r4081]
* After printing out the PDF manual and reading it through, here's aSimon Tatham2004-04-14
| | | | | | | | collection of minor edits for clarity, and also quite a few intended to keep down the length of lines in code paragraphs (because Courier is not just a thoroughly ugly font but is also WAY TOO WIDE). [originally from svn r4076]
* Jacob pointed out various important facts missing from the HalibutSimon Tatham2004-04-04
| | | | | | manual. Added them. [originally from svn r4038]
* For some reason I decided it was better to say `output format'Simon Tatham2004-04-01
| | | | | | | consistently in the documentation than to confuse matters by saying `back end'. One rogue back end removed. [originally from svn r4028]
* Simplify treatment of the copyright notice, now I've also simplifiedSimon Tatham2004-03-30
| | | | | | | | | the preamble: \copyright paragraphs are now treated identically to normal paragraphs (so they appear precisely where they're put instead of in a fixed location), _except_ that the Windows Help backend also copies their text into the help file's copyright slot. [originally from svn r4001]
* I always meant to remove emphasis in the index by default. Now I doSimon Tatham2004-03-30
| | | | | | so. It's restorable using \IM. [originally from svn r4000]
* The manual is now fully indexed.Simon Tatham2004-03-30
| | | | [originally from svn r3999]
* Couple of extra points: forgot about the \i\cw special case, andSimon Tatham2004-03-27
| | | | | | | Jacob points out that I didn't specify whether inline formatting commands can surround line breaks (they can). [originally from svn r3994]
* Second instalment of the manual: added a chapter on output formats.Simon Tatham2004-03-26
| | | | | | | | I _think_ the manual now contains all the information a user should need, even if not yet in an optimal order for a beginner to learn from. [originally from svn r3989]
* Introduce \. as a NOP command. The purpose of this is to act as aSimon Tatham2004-03-25
| | | | | | | | | zero-width delimiter between a macro invocation and text beyond it, so that you can define (say) a macro which expands to a Euro sign and then write `\eur\.2500' to avoid having space between the Euro sign and the number. [originally from svn r3982]
* Obsoleted the `\preamble' command. Preamble text is now taken to beSimon Tatham2004-03-25
| | | | | | | | | | any ordinary displayable paragraph(s) appearing before the first chapter heading, meaning in particular that you can put lists, code paragraphs etc in preambles. Of course, `\preamble' is still supported for backwards compatibility, but it's now a zero-effect paragraph marker. [originally from svn r3981]
* First instalment of a manual for Halibut. This lot covers theSimon Tatham2004-03-25
(nearly nonexistent) invocation syntax and the input format. [originally from svn r3979]