Re: Emacs markup language

[Lars Magne Ingebrigtsen <larsi@gnus.org>]

Per Abrahamsen <abraham@dina.kvl.dk> writes:

> But Emacs (and GNU) already has its own simple markup language, namely
> Texinfo (it also has info, but info sucks as a markup language, so
> let's forget that). 

That's an idea...  let's see

@title Configuring Gnus for reading news
@node Server name and port
@variable server :string (gnus-getenv-nntpserver)
@variable port :number 119
@validate
(let ((stream
        (condition-case err
           (open-network-stream "nntpd" nil server port)
          (error (setq error err)))))
   (if (memq (process-status stream) '(open run))
       (progn
         (delete-process stream)
         t)
     nil)))
@end validate
@result gnus-select-method (list server port)
@text
To read Usenet news with Gnus, you first have to tell
Gnus where the news server is.

The server name is @variable{server}; port number @variable{port}.
@end text


That was kinda pleasant to write, actually, and it's readable (and
therefore maintainable). 

And when there's a branch (when setting up mail, between pop and
file, say), we could have

@next Pop
@next Local file access

with different nodes called that, of course.

And each assistant would be in its own file, so that'd be the "name
space" that we're talking about.  .ass probably isn't the best suffix
to use, though.  .ast?  .fry?

-- 
(domestic pets only, the antidote for overdose, milk.)
  larsi@gnus.org * Lars Magne Ingebrigtsen