summaryrefslogtreecommitdiff
path: root/doc/input.but (unfollow)
Commit message (Collapse)Author
2016-01-22Mention \s in a section title.Simon Tatham
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.
2014-09-24Remove Subversion expanded keywords everywhere.Simon Tatham
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]
2013-03-23Index term tweaks in manual for \s to quell warnings when building, etc.Jacob Nevins
[originally from svn r9774]
2013-03-10Add \s for 'strong' text, i.e. bold rather than italics. I've missedSimon Tatham
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]
2010-01-14Clarify the section about backend-generic config options to make itSimon Tatham
look less as if they're the _only_ config options. [originally from svn r8842]
2007-01-28Use consistent capitalisation for HTML tags.Jacob Nevins
[originally from svn r7178]
2006-06-02Introduce global (cross-backend) \cfg{contents} and \cfg{index}Simon Tatham
commands, allowing the fixed words "Contents" and "Index" generated in various output formats to be reconfigured into other languages. [originally from svn r6724]
2005-02-18Add a `--list-charsets' option to Halibut to enumerate canonical names of knownJacob Nevins
character sets. (Also make libcharset `return_in_enum' values saner.) [originally from svn r5341] [this svn revision also touched charset,filter,timber]
2005-02-17Add \versionid.Jacob Nevins
[originally from svn r5338]
2005-02-17Changes/additions to input character set handling:Jacob Nevins
- 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]
2004-08-06Explicitly bless in the documentation, and fix in the man backend,Simon Tatham
the practice of using \dt and \dd in anything other than the obvious interleaving. [originally from svn r4417]
2004-07-16Right; I'm finally sick of typing \q{\cw{foo}}, so I've invented aSimon Tatham
shorthand command \cq{foo}. [originally from svn r4327]
2004-06-19Note that \cfg{quotes} and friends apply to the output in its entirety andJacob Nevins
can't be changed partway through. Also, add a cross-reference from \q{}. [originally from svn r4298]
2004-06-19Initial rough documentation of some of the newer \cfg{} directives, namely:Jacob Nevins
- \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]
2004-06-13The Halibut manual contained at least one instance of two indexSimon Tatham
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]
2004-06-12Er, don't forget to document the disallowing of \q within \c. Ahem.Simon Tatham
[originally from svn r4278]
2004-04-23Oh, and now the text backend warns about too-long code lines, I'dSimon Tatham
better remove the one too-long code line in the manual :-) [originally from svn r4129]
2004-04-20Don't forget to mention the default setting for \cfg{input-charset}.Simon Tatham
[originally from svn r4106]
2004-04-19Support for \cfg{input-charset}. Input files can now be in ASCII,Simon Tatham
8859-*, UTF-8, or a variety of more fun encodings including various multibyte ones. [originally from svn r4095]
2004-04-15Support the \W{...}\i\c{...} combination used in the NASM manual.Simon Tatham
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]
2004-04-14After printing out the PDF manual and reading it through, here's aSimon Tatham
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]
2004-04-04Jacob pointed out various important facts missing from the HalibutSimon Tatham
manual. Added them. [originally from svn r4038]
2004-04-01For some reason I decided it was better to say `output format'Simon Tatham
consistently in the documentation than to confuse matters by saying `back end'. One rogue back end removed. [originally from svn r4028]
2004-03-30Simplify treatment of the copyright notice, now I've also simplifiedSimon Tatham
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]
2004-03-30I always meant to remove emphasis in the index by default. Now I doSimon Tatham
so. It's restorable using \IM. [originally from svn r4000]
2004-03-30The manual is now fully indexed.Simon Tatham
[originally from svn r3999]
2004-03-27Couple of extra points: forgot about the \i\cw special case, andSimon Tatham
Jacob points out that I didn't specify whether inline formatting commands can surround line breaks (they can). [originally from svn r3994]
2004-03-26Second instalment of the manual: added a chapter on output formats.Simon Tatham
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]
2004-03-25Introduce \. as a NOP command. The purpose of this is to act as aSimon Tatham
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]
2004-03-25Obsoleted the `\preamble' command. Preamble text is now taken to beSimon Tatham
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]
2004-03-25First instalment of a manual for Halibut. This lot covers theSimon Tatham
(nearly nonexistent) invocation syntax and the input format. [originally from svn r3979]