IXIN 1.0 available

IXIN 1.0 available

[Thien-Thi Nguyen]

[-- Attachment #1: Type: text/plain, Size: 1246 bytes --]

release notes:

  Will there ever be a successor to the venerable .info format produced
  by makeinfo (GNU Texinfo)?  Will ‘@paragraphindent’ ever be a runtime
  tweakable slider?  Well, maybe if we kick some ideas around, backed by
  some experience, prospects will improve.

  Guile 2 lovers, please see in particular a1-nf3-guile2.

  thi

README excerpts:

  IXIN is an EXPERIMENTAL distribution of EXPERIMENTAL code.
  IXIN stands for "indexed texinfo".

  All code is under GPLv3+.  All (.xml) docs are under GFDL.

  [...]

  It defines a documentation file format and provides two simple
  tools to write and read, respectively, files in that format.

NEWS excerpt:

  - 1.0 | 2012-11-29
    - initial release

tarball, etc, in dir:

  http://www.gnuvola.org/software/ixin/

atom feed:

  http://www.gnuvola.org/NEWS.atom

-- 
Thien-Thi Nguyen ..................................... GPG key: 4C807502
.                  NB: ttn at glug dot org is not me                   .
.                 (and has not been since 2007 or so)                  .
.                        ACCEPT NO SUBSTITUTES                         .
........... please send technical questions to mailing lists ...........

[-- Attachment #2: Type: application/pgp-signature, Size: 197 bytes --]

Re: IXIN 1.0 available

[Ludovic Courtès]

Hi!

Thien-Thi Nguyen <ttn@gnuvola.org> skribis:

>   Will there ever be a successor to the venerable .info format produced
>   by makeinfo (GNU Texinfo)?  Will ‘@paragraphindent’ ever be a runtime
>   tweakable slider?  Well, maybe if we kick some ideas around, backed by
>   some experience, prospects will improve.

Sounds like good news!  I think it would be nice to discuss the goals of
IXIN, and detail its current status on bug-texinfo and
gnu-system-discuss, as people have shown interest in designing an Info
replacement.

>   Guile 2 lovers, please see in particular a1-nf3-guile2.

Here’s what I did in ~1.5 minute:

--8<---------------cut here---------------start------------->8---
scheme@(guile-user)> (use-modules (sxml simple))
scheme@(guile-user)> (call-with-input-file "hello.xml" xml->sxml )
sxml/upstream/SSAX.scm:2846:12: In procedure loop:
sxml/upstream/SSAX.scm:2846:12: Throw to key `parser-error' with args `(#<input: hello.xml 9> "[wf-entdeclared] broken for " copyright)'.

Entering a new prompt.  Type `,bt' for a backtrace or `,q' to continue.
scheme@(guile-user) [1]> ,frame
In sxml/upstream/SSAX.scm:
  2846:12  0 (loop #<input: hello.xml 9> () #f ())
scheme@(guile-user) [1]> ,proc
$1 = #<procedure loop (port entities expect-eof? seed)>
scheme@(guile-user) [1]> ,locals
  Local variables:
  $2 = port = #<input: hello.xml 9>
  $3 = entities = ()
  $4 = expect-eof? = #f
  $5 = seed = ()
  $6 = seed = ("Copyright ")
  $7 = term-token = (ENTITY-REF . copyright)
  $8 = key = ENTITY-REF
  $9 = seed = #<undefined>
scheme@(guile-user) [1]> (port-line $2)
$10 = 14
--8<---------------cut here---------------end--------------->8---

Then I look at line 15, and see &copyright;.  So, I go to
http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
and see that there’s no predefined ‘copyright’ entity in XML (and the
one in HTML is called ‘copy’.)  Same for &ldquo; and probably others.

And, as Guile 2 lovers know, the good thing is that you can instead use
the Unicode © and “ signs directly in the XML file.  Neat, no?  :-)

Thanks,
Ludo’.

Re: IXIN 1.0 available

[Ludovic Courtès]

Hi!

Thien-Thi Nguyen <ttn@gnuvola.org> skribis:

>   Will there ever be a successor to the venerable .info format produced
>   by makeinfo (GNU Texinfo)?  Will ‘@paragraphindent’ ever be a runtime
>   tweakable slider?  Well, maybe if we kick some ideas around, backed by
>   some experience, prospects will improve.

Sounds like good news!  I think it would be nice to discuss the goals of
IXIN, and detail its current status on bug-texinfo and
gnu-system-discuss, as people have shown interest in designing an Info
replacement.

>   Guile 2 lovers, please see in particular a1-nf3-guile2.

Here’s what I did in ~1.5 minute:

--8<---------------cut here---------------start------------->8---
scheme@(guile-user)> (use-modules (sxml simple))
scheme@(guile-user)> (call-with-input-file "hello.xml" xml->sxml )
sxml/upstream/SSAX.scm:2846:12: In procedure loop:
sxml/upstream/SSAX.scm:2846:12: Throw to key `parser-error' with args `(#<input: hello.xml 9> "[wf-entdeclared] broken for " copyright)'.

Entering a new prompt.  Type `,bt' for a backtrace or `,q' to continue.
scheme@(guile-user) [1]> ,frame
In sxml/upstream/SSAX.scm:
  2846:12  0 (loop #<input: hello.xml 9> () #f ())
scheme@(guile-user) [1]> ,proc
$1 = #<procedure loop (port entities expect-eof? seed)>
scheme@(guile-user) [1]> ,locals
  Local variables:
  $2 = port = #<input: hello.xml 9>
  $3 = entities = ()
  $4 = expect-eof? = #f
  $5 = seed = ()
  $6 = seed = ("Copyright ")
  $7 = term-token = (ENTITY-REF . copyright)
  $8 = key = ENTITY-REF
  $9 = seed = #<undefined>
scheme@(guile-user) [1]> (port-line $2)
$10 = 14
--8<---------------cut here---------------end--------------->8---

Then I look at line 15, and see &copyright;.  So, I go to
http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
and see that there’s no predefined ‘copyright’ entity in XML (and the
one in HTML is called ‘copy’.)  Same for &ldquo; and probably others.

And, as Guile 2 lovers know, the good thing is that you can instead use
the Unicode © and “ signs directly in the XML file.  Neat, no?  :-)

Thanks,
Ludo’.

Re: IXIN 1.0 available

[Thien-Thi Nguyen]

[-- Attachment #1: Type: text/plain, Size: 2448 bytes --]

() ludo@gnu.org (Ludovic Courtès)
() Thu, 29 Nov 2012 16:34:51 +0100

   I think it would be nice to discuss the goals of IXIN, and detail its
   current status on bug-texinfo and gnu-system-discuss, as people have
   shown interest in designing an Info replacement.

Good idea.  I'll post something to the latter shortly.

   >   Guile 2 lovers, please see in particular a1-nf3-guile2.

   Here’s what I did in ~1.5 minute:

   [debugging session]

   Then I look at line 15, and see &copyright;.  So, I go to
   http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references
   and see that there’s no predefined ‘copyright’ entity in XML (and the
   one in HTML is called ‘copy’.)  Same for “ and probably others.

Right.  Those are defined in the texinfo DTD.  What a1-nf3-mixp does,
that i don't know how to arrange for a1-nf3-guile2, is to recognize the
"http://www.gnu.org/software/texinfo/dtd/4.13/texinfo.dtd" in the
‘DOCTYPE’ declaration, find the associated DTD via map file zomg and
process it, to finally arrive at:

<!ENTITY copyright  "&#xa9;">

(excerpt from /usr/share/texinfo/texinfo.dtd:391).  IOW, ‘xml->sxml’ is
too abstracted from the details; it's not the right tool for the job.
Unfortunately, what is the right tool and how to use it i could not find
in my admittedly brief stroll through the SXML portions of the Guile
2.0.6 manual.  The resolution of this is to improve the documentation so
that non-prescient programmers like me can figure out how to specify
such a mapping (presuming that the underlying system is capable of
processing the DTD, etc).  Maybe that presumption is too much, even.
Who knows?

   And, as Guile 2 lovers know, the good thing is that you can instead
   use the Unicode © and “ signs directly in the XML file.  Neat, no?
   :-)

Yes, but unfortunately only tangential to the problem at hand, which
lies not w/ the user, or the producer of data, but w/ the programmer
and the opaque programming environment (to put it kindly).

-- 
Thien-Thi Nguyen ..................................... GPG key: 4C807502
.                  NB: ttn at glug dot org is not me                   .
.                 (and has not been since 2007 or so)                  .
.                        ACCEPT NO SUBSTITUTES                         .
........... please send technical questions to mailing lists ...........

[-- Attachment #2: Type: application/pgp-signature, Size: 197 bytes --]

Re: IXIN 1.0 available

[Ludovic Courtès]

Hi,

Thien-Thi Nguyen <ttn@gnuvola.org> skribis:

> Right.  Those are defined in the texinfo DTD.  What a1-nf3-mixp does,
> that i don't know how to arrange for a1-nf3-guile2, is to recognize the
> "http://www.gnu.org/software/texinfo/dtd/4.13/texinfo.dtd" in the
> ‘DOCTYPE’ declaration, find the associated DTD via map file zomg and
> process it, to finally arrive at:
>
> <!ENTITY copyright  "&#xa9;">

Oh, OK.

> (excerpt from /usr/share/texinfo/texinfo.dtd:391).  IOW, ‘xml->sxml’ is
> too abstracted from the details; it's not the right tool for the job.
> Unfortunately, what is the right tool and how to use it i could not find
> in my admittedly brief stroll through the SXML portions of the Guile
> 2.0.6 manual.  The resolution of this is to improve the documentation so
> that non-prescient programmers like me can figure out how to specify
> such a mapping (presuming that the underlying system is capable of
> processing the DTD, etc).  Maybe that presumption is too much, even.

(I concur that the doc of the sxml modules in Guile 2 is inappropriately
terse, and needs work.)

Regarding DTDs, there are hints in the thread at
<http://thread.gmane.org/gmane.lisp.scheme.ssax-sxml/327>, but nothing
really ideal.

Thanks,
Ludo’.

Re: IXIN 1.0 available

[Thien-Thi Nguyen]

[-- Attachment #1: Type: text/plain, Size: 763 bytes --]

() ludo@gnu.org (Ludovic Courtès)
() Thu, 29 Nov 2012 20:59:12 +0100

   Regarding DTDs, there are hints in the thread at
   <http://thread.gmane.org/gmane.lisp.scheme.ssax-sxml/327>, but
   nothing really ideal.

Thanks for the link.

Release 1.1, w/ pre-built .sxml and .ixin files for the benefit of Guile
2 (and those who choose not to install Mixp), coming right up...

-- 
Thien-Thi Nguyen ..................................... GPG key: 4C807502
.                  NB: ttn at glug dot org is not me                   .
.                 (and has not been since 2007 or so)                  .
.                        ACCEPT NO SUBSTITUTES                         .
........... please send technical questions to mailing lists ...........

[-- Attachment #2: Type: application/pgp-signature, Size: 197 bytes --]