NOWEB(7)

✨ NAME ✨

okay so bestie, this is the manual page for nowebstyle — it's the LaTeX package for noweb 💖 (it lives in the NOWEB(7) corner of the Miscellaneous Information Manual, if you were wondering where to find it 🫶)

---

🎀 SYNOPSIS 🎀

\usepackage{noweb}

that's it. that's the whole vibe. 💅

---

🌸 DESCRIPTION 🌸

so when noweave generates code for LaTeX, the noweb package is required — like, non-negotiable, she's coming with you. and on top of all the necessary arcana (yes she has arcana, she's mysterious like that ✨), she defines a webcode environment where you can drop fragments of code. inside that environment, only backslash and curly braces keep their special meanings — every other character is taken literally, no cap. she also defines a noweb pagestyle. and finally, she defines a \noweboptions{...} command so you can tinker with how the output looks. options get separated by commas, and they include:

• margintag — puts the sub-page number (the tag) of each code-chunk definition in the left margin. this is the default, she's the main character 💅
• nomargintag — don't use margin tags. that's it, that's the whole option 🙈
• shift — shift the text to the left so long code lines won't run off the right-hand side of the page. very considerate of her 🫶
• smallcode — sets code in the LaTeX \small font instead of \normalsize. and bestie, similar options exist for all the LaTeX size-changing commands, so go wild 💖
• longxref, shortxref, noxref — pick a style for chunk cross-referencing. long style uses small paragraphs after each chunk, like Knuth does. short style uses symbols on the definition line, like Hanson does. and noxref gives you no chunk cross-reference at all (sad, but valid 🥲). defaults to shortxref.
• alphasubpage, numsubpage, nosubpage — numbers chunks by the number of the page they show up on, followed by an alphabetic (numeric, not used) "sub-page" indicator. defaults to alphasubpage. and heads up: nosubpage implies nomargintag.
• webnumbering — number chunks consecutively, WEB style, instead of using sub-page numbers. old school, iconic ✨
• subscriptidents, nosubscriptidents, hyperidents, nohyperidents — these control subscripting of identifiers in code, including quoted code. picking subscriptidents means an identifier appearing in a code chunk (or in quoted code inside a documentation chunk) gets subscripted with the chunk number of its definition. hyperidents means those identifiers get hyperlinked to their definitions — provided, of course, that a hypertext package like hyperref is loaded. nosubscriptidents and nohyperidents are equivalent, and they turn off those markings. the default is hyperidents 💅
• subscriptquotedidents, nosubscriptquotedidents, hyperquotedidents, nohyperquotedidents — controls linking of identifiers just like above, but only applies to uses of identifiers in quoted code.
• hideunuseddefs — omits defined-but-unused identifiers from the local identifier cross-reference. (shoutout to Preston Briggs for this one 🫶)
• noidentxref — omits the local identifier cross-reference that follows each code chunk.
• externalindex — use an index generated with noindex(1) (q.v. 👀).
• longchunks — when expanding \nowebchunks, show the page numbers of definitions and uses of each chunk.
• english, french, german, portuges, icelandic — write cross-reference info in the language specified. defaults to english. (yes it's spelled portuges in the original, I don't make the rules, I just report them 😭 keep it exact bestie)

---

👑 CONTROL SEQUENCES 👑

the noweb package describes a gazillion special control sequences. only a few are listed here, so don't come for me about the rest 💀

• \nextchunklabel{l} — associates label l with the sub-page reference of the next code chunk. can be used for concise chunk cross-reference with, e.g., chunk~\subpageref{l}.
• \nwanchorto{URL}{anchor text} — creates a link to the given URL with the given anchor text. implemented in latex(1) using footnotes, but sl2h(1) translates this into <a href=URL>anchor text</a>
• \nwanchorname{name}{anchor text} — creates an anchor point for a hyperlink. implemented in latex(1) using \label , but sl2h(1) translates this into <a name=name>anchor text</a>
• \ifhtml ... \fi — text between \ifhtml and \fi is ignored by latex(1), but sl2h(1) and the l2h noweb filter translate that text into HTML. sneaky HTML pipeline, love that for her 🦋

---

💜 COMPATIBILITY 💜

for compatibility with plain TeX, noweb keeps using the old-style font commands \tt and so on. and when she's used with the KOMA scripts (document classes scrartcl, scrreprt, and scrbook), noweb needs the document-class option enabledeprecatedfontcommands. don't forget it, or it's giving ✨errors✨

---

🦋 SEE ALSO 🦋

• noweave(1)
• noweb(1)

---

🍓 VERSION 🍓

this man page is from noweb version 2.12.

---

🌈 AUTHOR 🌈

Norman Ramsey, Tufts University. Internet address Norman.Ramsey@tufts.edu.

noweb home page at http://www.cs.tufts.edu/~nr/noweb.

---

and that's a wrap bestie!! 🎀 this came to you from the local source, dated 10/40/2008, page NOWEB(7) — yes the date says 10/40 and no I will not be explaining that, it's just the lore 💅 slay, go write some literate code, periodt 💖✨