<beach>
g-gundam: In the past, I always used LaTeX, but that seems to be frowned upon these days. So I have started using Texinfo instead. But only yesterday, I had a problem that I couldn't figure out how to make an arbitrary table.
pabs3 has quit [Ping timeout: 252 seconds]
<beach>
I also don't know how to make a bibliography in Texinfo.
decweb has quit [Quit: Konversation terminated!]
<g-gundam>
I'm no texinfo expert. I've only managed to turn previous dislike into a mild appreciation as a user (not an author).
<beach>
g-gundam: And some of us are working on a documentation system according to the principles on that page.
<g-gundam>
beach: Going back to your first response to me, you weren't kidding when you said there were many tools to choose from. I found this summary while searching. https://cl-doc-systems.github.io/
<ixelp>
Common Lisp Documentation Builders
<beach>
Oh, but that's an entirely different can of worms. I totally do not believe that you can generate document. It has to be written. And I totally do not believe that a collection of documentation strings can provide adequate documentation for a system, no matter how they are massaged into a single document.
<g-gundam>
beach: I agree with you there on both points.
<beach>
Thanks.
<g-gundam>
One of my concerns is being able to publish on the web, so that's why I was looking at that stuff.
<beach>
Yes, I see.
<beach>
That might be one reason LaTeX is frowned upon these days.
edgar-rft` has joined #commonlisp
<g-gundam>
Going back to the "Surface syntax is overrated" link you shared, I agree with the main point made there too (about focusing on data structures instead of superficial syntax). A lot of doc systems for code fall short here.
istewart has quit [Quit: Konversation terminated!]
bpanthi977 has quit [Ping timeout: 252 seconds]
rgherdt has joined #commonlisp
wbooze has joined #commonlisp
varjag has joined #commonlisp
donlcn has joined #commonlisp
<beach>
g-gundam: I don't see any difference between Scribble and any other system defined in terms of surface syntax.
<beach>
g-gundam: Like, I don't see the definition of the class/type SECTION and the (perhaps generic) functions that can operate on an instance of that class/type.
<beach>
But maybe I am missing something.
squishy_bloob has quit [Remote host closed the connection]
<jackdaniel>
you are missing that your expectations from the documentation system are not necessarily the same as other people; many people only care about the surface syntax and expect from it to be convenient for writing documentation
admich1 has quit [Ping timeout: 268 seconds]
<jackdaniel>
and then to have a compiler from the source code to the final document (i.e a nicely formatted pdf)
scymtym has quit [Read error: Connection reset by peer]
notzmv has quit [Read error: Connection reset by peer]
scymtym has joined #commonlisp
shka has joined #commonlisp
gorignak has quit [Read error: Connection reset by peer]
gorignak has joined #commonlisp
yitzi has joined #commonlisp
yitzi has quit [Client Quit]
yitzi has joined #commonlisp
acdw has quit [Quit: See You Space Cowpokes . . . . .]
reb has joined #commonlisp
shka has quit [Quit: Konversation terminated!]
gorignak has quit [Ping timeout: 276 seconds]
gorignak has joined #commonlisp
shka has joined #commonlisp
ewig has quit [Remote host closed the connection]
ingeniot has quit [Ping timeout: 248 seconds]
triffid has quit [Remote host closed the connection]
admich1 has quit [Ping timeout: 276 seconds]
shka has quit [Quit: Konversation terminated!]
ixelp has quit [Ping timeout: 276 seconds]
ixelp has joined #commonlisp
pve has quit [Quit: leaving]
admich1 has joined #commonlisp
tuck has quit [Ping timeout: 260 seconds]
<g-gundam>
Zürich
<gilberth>
ISO-8859-1 is the default for HTTP and whatever the transport says takes priority over any META tag. This is why I always use 7-bit US-ASCII when making HTML. That's what is happening.
istewart has joined #commonlisp
triffid has joined #commonlisp
shka has joined #commonlisp
GalaxyNova has joined #commonlisp
mgl has quit []
nefercheprure is now known as TMA
attila_lendvai has quit [Ping timeout: 260 seconds]