scrollkeeper-devel — Developer discussion list for ScrollKeeper

Re: [Scrollkeeper-devel] ScrollKeeper 0.3.7 Released

[Dan M. <mu...@al...>]

On Tue, 16 Apr 2002, John Fleck wrote:

> On Tue, Apr 16, 2002 at 01:12:53AM -0500, Dan Mueth wrote:
> > 
> > ScrollKeeper 0.3.7 is now available.
> [snip]
> >    * Added DTD for OMF files.
> >    * Now require OMF files validate against DTD.  Made error reporting and
> >      logging sane for validation.
> >    * Updated documentation to reflect new variant of the DTD, which is
> >      slightly different from the previous guide for OMF file structure.
> 
> So what happens to the install process when SK hits an older OMF that
> doesn't comply? And what happens if someone has still an old SK and it
> hits one of the modified OMF files?

If you have a new (ie >= 0.3.7) ScrollKeeper, it will try to validate each
OMF file it encounters.  If it doesn't validate, then it ignores it.  So,
only updated OMF files (ie. where the subject, rights, and version
elements have attributes but not children) will be registered with
ScrollKeeper.

If you have an older (ie <= 0.3.6) ScrollKeeper, the new OMF files will 
only partially be registered (ie. they won't appear in the contents list).

Urg.  I just realized I forgot to make an update needed for 0.3.7, so it 
doesn't list docs with the new OMF files in the contents list either :(  I 
guess we'll need a 0.3.8 right away.

Dan

Re: [Scrollkeeper-devel] ScrollKeeper 0.3.7 Released

[Dan M. <mu...@al...>]

On 16 Apr 2002, Mikael Hallendal wrote:

> tis 2002-04-16 klockan 08.12 skrev Dan Mueth:
> > 
> > ScrollKeeper 0.3.7 is now available.
> 
> Thanks a lot!
> 
> Would it be possible to install the locations from vicious-build-scripts
> (/gnome/head/INSTALL/share/oaf) and the default locations for the
> various other buildscripts in /etc/scrollkeeper.conf. I see lots of
> weird locations in there now so I figure just adding a few extra
> shouldn't be a problem?

Sure.  I could just stuff them in the default file.  I wonder, though, if 
there is a more flexible and elegant way of doing it.  Perhaps by passing 
a flag to configure/autogen.sh listing any paths which aren't fairly 
standard.  Then autoconf could stick them in scrollkeeper.conf.  I haven't 
tried this, but I suspect it should work fine.  Or is there a better way?

Dan

Re: [Scrollkeeper-devel] ScrollKeeper 0.3.7 Released

[John F. <jf...@in...>]

On Tue, Apr 16, 2002 at 01:12:53AM -0500, Dan Mueth wrote:
> 
> ScrollKeeper 0.3.7 is now available.
[snip]
>    * Added DTD for OMF files.
>    * Now require OMF files validate against DTD.  Made error reporting and
>      logging sane for validation.
>    * Updated documentation to reflect new variant of the DTD, which is
>      slightly different from the previous guide for OMF file structure.

So what happens to the install process when SK hits an older OMF that
doesn't comply? And what happens if someone has still an old SK and it
hits one of the modified OMF files?

I'm asking because we'll need to update the OMF files throughout, but
I want to understand the consequences.

Cheers,
John
-- 
John Fleck
jf...@in... (h) jf...@ab... (w)
http://www.inkstain.net http://www.abqjournal.com

"You don't want to die with the music still in you."
 - John Gardner

Re: [Scrollkeeper-devel] ScrollKeeper 0.3.7 Released

[Mikael H. <mi...@co...>]

tis 2002-04-16 klockan 08.12 skrev Dan Mueth:
> 
> ScrollKeeper 0.3.7 is now available.

Thanks a lot!

Would it be possible to install the locations from vicious-build-scripts
(/gnome/head/INSTALL/share/oaf) and the default locations for the
various other buildscripts in /etc/scrollkeeper.conf. I see lots of
weird locations in there now so I figure just adding a few extra
shouldn't be a problem?

Regards,
  Mikael Hallendal

-- 
Mikael Hallendal                mi...@co...
CodeFactory AB                  http://www.codefactory.se/
Office: +46 (0)8 587 583 05     Cell: +46 (0)709 718 918

[Scrollkeeper-devel] ScrollKeeper 0.3.7 Released

[Dan M. <mu...@al...>]

ScrollKeeper 0.3.7 is now available.

New in this release:
   * Fixed problem with commas being inserted into tags in some locales,
     by requiring libxml2 >= 2.4.19 which fixes this problem.
   * Improved output and logging for translations of contents list
   * Fixed bug regarding linking against libxml2.
   * Updated INSTALL and TODO files.
   * Merged a couple bug fixes and various other small improvements from
     the Red Hat package.
   * Added DTD for OMF files.
   * Now require OMF files validate against DTD.  Made error reporting and
     logging sane for validation.
   * Updated documentation to reflect new variant of the DTD, which is
     slightly different from the previous guide for OMF file structure.
   * Bug fix in omf.make which made 'make distcheck' fail.
   * Bug fix allowing ScrollKeeper to build a database in directories 
     whose parents don't exist.
   * Added a stylesheet for converting the categories file into an HTML 
     page for easy access to OMF file authors.

You can get ScrollKeeper 0.3.7 at:
        http://sourceforge.net/projects/scrollkeeper

If you find any bugs, please submit them to the bug tracker at:
        http://sourceforge.net/tracker/?group_id=11543&atid=111543
Please be sure to include your name and email address in any bugs you
enter so we can contact you if necessary.

If you would like to contribute to ScrollKeeper:
There are instructions for getting the latest source from CVS at:
        http://scrollkeeper.sourceforge.net/cvs.shtml
Look over the TODO list in the tarball or CVS and the bug list on the web,
find something you're interested in working on, and email
scr...@li... with your choice so that others
don't duplicate your work.

- The ScrollKeeper Team

[Scrollkeeper-devel] Re: ScrollKeeper Categories List

[Andreas J. G. <agu...@ta...>]

Alexander Kirillov wrote:

> Here is one category which is missing in the current list: 
> Applications->Office->Spreadsheet
> (because of this, gnumeric had to go to applications->office->other)
> 

If a spreadsheet is not `Data-Processing', then what would be an example 
of Data-Processing ?

Andreas



-- 
Prof. Dr. Andreas J. Guelzow
http://www.math.concordia.ab.ca/aguelzow

[Scrollkeeper-devel] Re: ScrollKeeper Categories List

[Alexander K. <kir...@ma...>]

Here is one category which is missing in the current list: 
Applications->Office->Spreadsheet
(because of this, gnumeric had to go to applications->office->other)

Also: in category "GNOME", we probably want a category for general docs
such as GNOME User's guide, "intro to gnome", etc. They currently go
into "core desktop", which I do not think is the best place. 


Sasha

On Fri, 2002-04-12 at 01:18, Dan Mueth wrote:
> 
> A list of ScrollKeeper categories is now available in readable (ie. HTML)  
> format.  For the current categories, see:
> 
> http://scrollkeeper.sourceforge.net/documentation/categories.html
> 
> This HTML file is generated by an XSL stylesheet which is in CVS and will 
> be shipped with future releases of ScrollKeeper.  It sounds like Eric 
> Baudais will give this stylesheet some attention and make the output more 
> readable than it is now.
> 
> The category list itself could use some work.  If anybody is interested in
> developing the category list, your help would be appreciated.  Email me
> for details.
> 
> Dan
> 
> _______________________________________________
> gnome-doc-list mailing list
> gno...@gn...
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list

[Scrollkeeper-devel] Re: ScrollKeeper Categories List

[Dan M. <mu...@al...>]

On Fri, 12 Apr 2002, Jeff Waugh wrote:

> <quote who="Dan Mueth">
> 
> > The category list itself could use some work.  If anybody is interested in
> > developing the category list, your help would be appreciated.  Email me
> > for details.
> 
> How about using Trove categories (as SourceForget does)?
> 
>   http://www.tuxedo.org/~esr/trove/

I guess great minds think alike:)  ESR also proposed this, at the O'Reilly
Open Documentation Summit when we initially proposed and discussed
ScrollKeeper.  We eventually decided to incorporate a lot of the trove
categories, but make our own category list which is tailored to
documentation on or relating to typical open computer open systems (ie. it
should contain categories for software and documentation licenses,
tutorials, computer hardware, etc. which do not correspond directly to a
single piece of software and thus aren't in Trove).  

We should go through Trove again and see if we left out things which we
should include, since the largest part of the ScrollKeeper categories
overlap with particular software groups as represented by Trove.

Dan

[Scrollkeeper-devel] Re: ScrollKeeper Categories List

[Jeff W. <jd...@pe...>]

<quote who="Dan Mueth">

> The category list itself could use some work.  If anybody is interested in
> developing the category list, your help would be appreciated.  Email me
> for details.

How about using Trove categories (as SourceForget does)?

  http://www.tuxedo.org/~esr/trove/

- Jeff

-- 
                W.O.R.K: Weekend Over, Resume the Killings.                 

[Scrollkeeper-devel] ScrollKeeper Categories List

[Dan M. <mu...@al...>]

A list of ScrollKeeper categories is now available in readable (ie. HTML)  
format.  For the current categories, see:

http://scrollkeeper.sourceforge.net/documentation/categories.html

This HTML file is generated by an XSL stylesheet which is in CVS and will 
be shipped with future releases of ScrollKeeper.  It sounds like Eric 
Baudais will give this stylesheet some attention and make the output more 
readable than it is now.

The category list itself could use some work.  If anybody is interested in
developing the category list, your help would be appreciated.  Email me
for details.

Dan

[Scrollkeeper-devel] Re: ScrollKeeper, OMF files, KDE, etc.

[Stephan K. <co...@kd...>]

On Wednesday 10 April 2002 07:53, Dan Mueth wrote:
> My first concern is the possibility that I may invalidate existing OMF
> files which people intend to work properly with the upcoming stable
> ScrollKeeper release.  Does KDE currently install OMF files?  I know GN=
OME
> is rewriting their OMF files for ScrollKeeper 0.4, but I want to make s=
ure
> there aren't a lot of KDE OMF files installed which start being rejecte=
d
> when ScrollKeeper begins validing OMF files.
KDE doesn't do OMF for 3.0.x - the earliest release to have it is 3.1

Greetings, Stephan

[Scrollkeeper-devel] ScrollKeeper-OMF DTD / 0.3.7beta5

[Dan M. <mu...@al...>]

I just committed Eric's latest ScrollKeeper-OMF DTD to CVS, along with 
updates to the docs and example OMF files in them.  It should now be 
properly validating against this DTD and using the structure discussed in 
the docs (in the package, but not yet updated on the web site).

If you download it from CVS and play with it at all, give us your feedback 
on how well it works.  It should reject old OMF files as invalid.  See the 
Writing ScrollKeeper OMF Files doc in the package for the new form.

Note that it keeps a log of its activity in /var/log/scrollkeeper.log.  
To get verbose information to STDOUT on any DTD inconsistancies, use the
-v (verbose)  flag to scrollkeeper-udpate, scrollkeeper-install, or
scrollkeeper-rebuilddb.  Or, you can use xmllint to validate against the 
DTD.

If no problems pop up, this will become 0.3.7 in a day or two.

-Dan

[Scrollkeeper-devel] ScrollKeeper, OMF files, KDE, etc.

[Dan M. <mu...@al...>]

Hi everybody,

Things have been pretty quiet on the ScrollKeeper mailing list lately, so
first let me give a little update: We are approaching our second stable
release, 0.4.0.  New in this release will be support for XML/DocBook docs=
,
index extraction from DocBook/XML docs, better i18n, and a few other
goodies.

In order to implement the features which make ScrollKeeper interesting,
we've added a few ScrollKeeper-specific extensions to the OMF.  It is our
hope that we can get these accepted into the standard OMF metadata.  I
have not been anxious to push this in the past since ScrollKeeper is stil=
l
developing.  Now may be a good time to discuss these issues though.

For a mostly up-to-date description of the differences, see:
http://scrollkeeper.sourceforge.net/documentation/writing_scrollkeeper_om=
f_files/ar01s04.html

In the process of stabilizing the latest development releases, we decided
to require OMF files validate against a DTD.  For this, we have
updated/adapted the standard OMF DTD.  In a couple places, we have added
new attributes (some of which are required).  We have also decided to mak=
e
only the standard 16 OMF elements as XML elements, with all of their
'attributes' as XML attributes.  In contrast, the official OMF DTD has
some things (rights, version, and subject) identified as attributes in
http://www.ibiblio.org/osrt/omf/omf_elements implemented as children.

My first concern is the possibility that I may invalidate existing OMF
files which people intend to work properly with the upcoming stable
ScrollKeeper release.  Does KDE currently install OMF files?  I know GNOM=
E
is rewriting their OMF files for ScrollKeeper 0.4, but I want to make sur=
e
there aren't a lot of KDE OMF files installed which start being rejected
when ScrollKeeper begins validing OMF files.

My second concern is that the OMF as implemented in ScrollKeeper is slowl=
y
diverging from the official OMF.  It would be a good idea to compare the
the OMF spec, the offical OMF DTD, and the ScrollKeeper OMF DTD and decid=
e=20
how we can bring them all into line with each other.  (Or if it is even a=
=20
good thing to have them all be the same?)

My third concern is that we should make sure that we are content with the
OMF implemented by ScrollKeeper.  The backwards-incompatible change we're
making right now probably won't cause any real problems since the install
base is small and since the new GNOME and ScrollKeeper releases will be
fairly synchronous.  In the future it will be much harder to change
things.  So lets try to finalize things soon.  If you have any great
suggestions for changes, lets hear them :)

I'd also like to revive the discussion of merging the OMF into DocBook. =20
This would make things a bit easier on people.  I think we can follow =C9=
ric
Bischoff's suggestion of using a namespace mechanism to include the OMF
metadata in DocBook without conflicts with existing DocBook tags.  Then w=
e
can write an XSLT stylesheet to generate an OMF file from a DocBook doc. =
=20
ScrollKeeper can include this stylesheet along with a short script to run
it, and it can be called at build time to generate the OMF file and
include it in the package.  It sounded like there was a rough concensus o=
n
this approach last spring when it was last discussed, although it would b=
e
good to go over this quickly again.  If people still like the idea, then=20
we should start by trying to finalize the DTD and then ask Norm to work i=
t=20
into DocBook.

Dan

Re: [Scrollkeeper-devel] Compiling under FreeBSD

[Andrew B. <an...@cr...>]

Andrew Boothman wrote:

>
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c:290: 
> undefined reference to `gettext'
> separate.o: In function `main':
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x690): 
> undefined reference to `bindtextdomain'
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x6a0): 
> undefined reference to `textdomain'
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x6f4): 
> undefined reference to `gettext'
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x792): 
> undefined reference to `gettext'
> gmake[2]: *** [scrollkeeper-tree-separate] Error 1 

It might be helpful to add that the lines immediately above these errors 
were :

Making all in buildtools
gmake[2]: Entering directory 
`/usr/home/andrew/scrollkeeper-0.3.6/buildtools'
gcc -DHAVE_CONFIG_H -I. -I. -I.. -I../libs 
-I/usr/local/include/libxml2/libxml -I/usr/local/include/libxml2 
-I/usr/local/include    -g -O2 -c separate.c
/bin/sh ../libtool --mode=link gcc  -g -O2  -o 
scrollkeeper-tree-separate  separate.o -L/usr/local/lib -lxml2 -lz 
-L/usr/local/lib -liconv -lm -L/usr/local/lib -L/usr/local/lib -lxslt 
-lxml2 -lz -liconv -lm ../libs/libscrollkeeper.la
mkdir .libs
gcc -g -O2 -o .libs/scrollkeeper-tree-separate separate.o  
-L/usr/local/lib -lxml2 -lz -liconv -lm -lxslt -lxml2 -lz -liconv -lm 
../libs/.libs/libscrollkeeper.so
separate.o: In function `usage':

Thanks again!

Re: [Scrollkeeper-devel] Compiling under FreeBSD

[Andrew B. <an...@cr...>]

John Fleck wrote:

>On Sun, Mar 31, 2002 at 05:30:08PM +0100, Andrew Boothman wrote:
>
>>Hi all!
>>
>>I was wondering if anyone on here has had any success compiling 
>>scrollkeeper-0.3.6 under FreeBSD?
>>
>>I'm not really sure where to go to sort this problem, I currently have 
>>gettext-0.10.35_1 installed. Do I need a newer version? FreeBSD Ports 
>>also contains gettext-0.10.40 but it's listed as gettext-devel. Is that 
>>what I need?
>>
>
>I don't know anything about gettext-BSD issues, but if it's any help
>the version of I'm using on Linux is gettext-0.10.38-7.
>
John, thanks for your help.

Unfortunately, I tried upgrading my gettext to 0.10.40 but it's made no 
difference and the error is the same.

Does anyone know where scrollkeepers compilation process will be looking 
for gettext? It's likely it is stored in a different place under FreeBSD 
and that is causing this problem.

Andrew.

Re: [Scrollkeeper-devel] Compiling under FreeBSD

[John F. <jf...@in...>]

On Sun, Mar 31, 2002 at 05:30:08PM +0100, Andrew Boothman wrote:
> Hi all!
> 
> I was wondering if anyone on here has had any success compiling 
> scrollkeeper-0.3.6 under FreeBSD?
> 
> I think I have all scrollkeeper's dependancies sorted, but when I 
> compile I get :
> 
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c:290: undefined 
> reference to `gettext'
> separate.o: In function `main':
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x690): 
> undefined reference to `bindtextdomain'
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x6a0): 
> undefined reference to `textdomain'
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x6f4): 
> undefined reference to `gettext'
> /usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x792): 
> undefined reference to `gettext'
> gmake[2]: *** [scrollkeeper-tree-separate] Error 1
> 
> I'm not really sure where to go to sort this problem, I currently have 
> gettext-0.10.35_1 installed. Do I need a newer version? FreeBSD Ports 
> also contains gettext-0.10.40 but it's listed as gettext-devel. Is that 
> what I need?
> 
> I'd like to see scrollkeeper working under FreeBSD as it looks like a 
> very interesting technonogy.
> 

Andrew - 
I don't know anything about gettext-BSD issues, but if it's any help
the version of I'm using on Linux is gettext-0.10.38-7.

Cheers,
John

-- 
John Fleck
jf...@in... (h) jf...@ab... (w)
http://www.inkstain.net http://www.abqjournal.com

"You don't want to die with the music still in you."
 - John Gardner

[Scrollkeeper-devel] Compiling under FreeBSD

[Andrew B. <an...@cr...>]

Hi all!

I was wondering if anyone on here has had any success compiling 
scrollkeeper-0.3.6 under FreeBSD?

I think I have all scrollkeeper's dependancies sorted, but when I 
compile I get :

/usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c:290: undefined 
reference to `gettext'
separate.o: In function `main':
/usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x690): 
undefined reference to `bindtextdomain'
/usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x6a0): 
undefined reference to `textdomain'
/usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x6f4): 
undefined reference to `gettext'
/usr/home/andrew/scrollkeeper-0.3.6/buildtools/separate.c(.text+0x792): 
undefined reference to `gettext'
gmake[2]: *** [scrollkeeper-tree-separate] Error 1

I'm not really sure where to go to sort this problem, I currently have 
gettext-0.10.35_1 installed. Do I need a newer version? FreeBSD Ports 
also contains gettext-0.10.40 but it's listed as gettext-devel. Is that 
what I need?

I'd like to see scrollkeeper working under FreeBSD as it looks like a 
very interesting technonogy.

Thanks.

Andrew.

Re: [Scrollkeeper-devel] unknown error with scrollkeeper

[Dan M. <mu...@al...>]

I'm not sure where things are going wrong.  It looks like 
scrollkeeper-tree-separate is failing to generate the various locale 
files, perhaps because intltool-merge is not creating a good 
scrollkeeper_cl.xml in cl/templates.  Could you send me this file?

I just made some updates to scrollkeeper-tree-separate so that it will
give some more useful output.  Try it out from CVS.  After you build, go
into cl/templates/ and do 'make clean' and then 'make' and see exactly
what output it gives, and what scrollkeeper_cl.xml in this directory looks
like.

I don't think any environment variables will affect this, but maybe 
something unforeseen is happening.

Dan


On Tue, 26 Mar 2002, DanteAliegri wrote:

> I'm having 2 problems with scrollkeeper.
> they both happen in cvs as well as 0.3.6
> 
> The first is that when I got to install, make install
> wants to install scrollkepper_cl.xml
> from cl/templates/$locale
> but the only directory there is C.
> I took a cursory look at configure,
> and it seems to unset all of NLS stuff,
> so I don't think the lack of that in my enviroment variables could be 
> doing anything.
> 
> The secound error occurs when I fix that install 'error'.
> when make install runs scrollkeeper-rebuilddb
> an examples of the errors are
> 
> /var/lib/scrollkeeper/C/scrollkeeper_cl.xml:3694: error: Attribute 
> categorycode redefined
> ="GNOMEMultimedia" categorycode="GNOMEMultimedia" 
> categorycode="GNOMEMultimedia
>                                                                          
>                                                                         
>                   ^
> it repeats this a lot.
> 
> I took the INSTALL's instructions, and did  ./configure 
> --localstatedir=/var --prefix=/usr --sysconfdir=/etc
> libxml2 and libxslt are installed in /usr/local
> docbook and docbook-xsl are installed to whereever the makefiles put 
> them ( both downloaded from the scrollkeeper site )
> 
> If anyone needs any more info, just email.
> please remember to cc; me when replying, since I'm not on the list.
> 
> --Dante
> 
> 
> 
> 
> _______________________________________________
> Scrollkeeper-devel mailing list
> Scr...@li...
> https://lists.sourceforge.net/lists/listinfo/scrollkeeper-devel
> 

[Scrollkeeper-devel] unknown error with scrollkeeper

[DanteAliegri <og...@um...>]

I'm having 2 problems with scrollkeeper.
they both happen in cvs as well as 0.3.6

The first is that when I got to install, make install
wants to install scrollkepper_cl.xml
from cl/templates/$locale
but the only directory there is C.
I took a cursory look at configure,
and it seems to unset all of NLS stuff,
so I don't think the lack of that in my enviroment variables could be 
doing anything.

The secound error occurs when I fix that install 'error'.
when make install runs scrollkeeper-rebuilddb
an examples of the errors are

/var/lib/scrollkeeper/C/scrollkeeper_cl.xml:3694: error: Attribute 
categorycode redefined
="GNOMEMultimedia" categorycode="GNOMEMultimedia" 
categorycode="GNOMEMultimedia
                                                                         
                                                                        
                  ^
it repeats this a lot.

I took the INSTALL's instructions, and did  ./configure 
--localstatedir=/var --prefix=/usr --sysconfdir=/etc
libxml2 and libxslt are installed in /usr/local
docbook and docbook-xsl are installed to whereever the makefiles put 
them ( both downloaded from the scrollkeeper site )

If anyone needs any more info, just email.
please remember to cc; me when replying, since I'm not on the list.

--Dante

[Scrollkeeper-devel] ScrollKeeper 0.3.6 Released

[Dan M. <mu...@al...>]

ScrollKeeper 0.3.6 is now available.

New in this release:
   * Fixed duplicate id in Writing ScrollKeeper OMF Files which caused an
     error spew on installation.
   * Updated INSTALL file to have better information on dependencies and
     building.
   * Updated translations: Danish, Norwegian, Slovenian
   * Fixed a handful of errors that only show up on Solaris (thanks to
     Morten Welinder <te...@di...>).
   * Removed obsolete scrollkeeper_toc.
   * Added latest draft of specifications document.
   * Fixed call for libxml header files to avoid potentially loading
     other header files with the same name. (Thanks to Daniel Veillard
     <vei...@re...>).
   * Cleaned up configure script.
   * Rewrote doc and OMF file build and install scripts to resemble
     that from scrollkeeper-example2.

You can get ScrollKeeper 0.3.6 at:
        http://sourceforge.net/projects/scrollkeeper

If you find any bugs, please submit them to the bug tracker at:
        http://sourceforge.net/tracker/?group_id=11543&atid=111543
Please be sure to include your name and email address in any bugs you
enter so we can contact you if necessary.

If you would like to contribute to ScrollKeeper:
There are instructions for getting the latest source from CVS at:
        http://scrollkeeper.sourceforge.net/cvs.shtml
Look over the TODO list in the tarball or CVS and the bug list on the web,
find something you're interested in working on, and email
scr...@li... with your choice so that others
don't duplicate your work.

- The ScrollKeeper Team

[Scrollkeeper-devel] Commas in ScrollKeeper XML files

[Dan M. <mu...@al...>]

Hi everybody,

I thought I should forward this email to scrollkeeper-devel, since at 
least a couple people have had problems with commas being inserted into 
their TOC and index files where they shouldn't be.  The short summary is 
that this is locale-dependent, and that the bug was in either libxml2 or 
in glibc.  However, Daniel Veillard fixed the way libxml2 formats the 
relevant text so the problem should go away in the next release of 
libxml2.  (I'm not sure when that will be, or what version number it will 
have.)

Dan

---------- Forwarded message ----------
Date: Tue, 19 Mar 2002 06:45:05 -0500
From: Daniel Veillard <vei...@re...>
To: Dan Mueth <mu...@al...>
Cc: gno...@gn...
Subject: Re: libxml2, scrollkeeper, and commas in tags

On Tue, Mar 19, 2002 at 12:43:42AM -0600, Dan Mueth wrote:
> 
> On Wed, 13 Mar 2002, Daniel Veillard wrote:
> 
> >   Guys, this is frustrating. There is a bug, at least 2 persons have seen
> > it, it seems related to libxslt not doing the right thing, I asked for
> > a reproductible test but didn't got anything, not even basic informations
> > about the platform being used.
> 
> I wish we could have found a reproducable test case earlier, but I'm not
> sure anybody is worthy of finger-pointing here.  The only two people who
> observed it both thought it was a bug in ScrollKeeper and reported it to
> me.  I couldn't reproduce it, but did what I could to investigate the
> ScrollKeeper stylesheets for a bug.  Meanwhile I was emailing and cc'ing
> some of the emails to you just in case it was a problem with libxml.  So,
> you really haven't missed out on much here.

  Okay, I probably had too much coffee that day :-\

> We do (finally) have a reproducable test case:  It seems that the bug is 
> only seen in certain locales (eg. sv_SE but not C).
> 
> If you have scrollkeeper-0.3.5 (from
> https://sourceforge.net/project/showfiles.php?group_id=11543&release_id=24049),

  Okay, installed. BTW installing the RPM generated a validity error:

[root@paphio tmp]# rpm -U ~veillard/scrollkeeper-0.3.5-1.i386.rpm ~veillard/docbook-dtd412-xml-1.0-1.noarch.rpm 
/usr/share/scrollkeeper/doc/writing_scrollkeeper_omf_files/C/writing_scrollkeeper_omf_files.xml:783: validity error: ID skomf-seriesid already defined
    <sect2 id="skomf-seriesid">
			      ^
[root@paphio tmp]# 

> you can do:
> 
> xsltproc /usr/share/scrollkeeper/stylesheets/toc.xsl 
> /usr/share/scrollkeeper/doc/writing_scrollkeeper_omf_files/C/writing_scrollkeeper_omf_files.xml
> 
> and you get good output for both C and sv_SE in LC_ALL.

  Okay

> If you use the ScrollKeeper extraction code, you see the problem:
> 
> scrollkeeper-extract 
> /usr/share/scrollkeeper/doc/writing_scrollkeeper_omf_files/C/writing_scrollkeeper_omf_files.xml 
> /usr/share/scrollkeeper/stylesheets/toc.xsl /tmp/junk
> 
> ie. for sv_SE, there are commas (,) inserted into the tags in the output 
> file, /tmp/junk.

  Okay I can reproduce this with the binary from the RPM.
I recompiled scrollleeper, it need to be fixed in the way it includes
libxml2 headers (c.f. my mail to gnome-hackers last week):
   gcc -DHAVE_CONFIG_H -I. -I. -I../.. -I../../libs -I/usr/include/libxml2    -g -O2 -c toc.c
   In file included from toc.c:26:
   toc.h:25:20: parser.h: Filen eller katalogen finns inte
   toc.h:26:29: parserInternals.h: Filen eller katalogen finns inte
   toc.h:27:17: SAX.h: Filen eller katalogen finns inte
   toc.h:28:23: xmlmemory.h: Filen eller katalogen finns inte

 patch enclosed.

> The main code being used here is (from libs/extract.c):
[...]
> }

  Hum, it was actually deep into the XPath number to string formatting
functions.
  The problem seems to be that in that locale, snprintf does not
follow the same conventions by postfixing the value with the float separator
even if there is no suffix to be written (note that the way the stylesheet is
written using attribute value template to propagate the value of toclevel,
the XPath engine is requested to go from the string representation to
the float representation and back a lot).
  
0x08095402 in xmlXPathFormatNumber (number=1, buffer=0xbfffc310 "\bõ\r\bP", 
    buffersize=100) at xpath.c:1115
1163			size = snprintf(work, sizeof(work), "%0.*f",
(gdb) 
(gdb) p work
$18 = "1,", '0' <repeats 14 times>, "\000\000\000\000\000\000ð"

  I fixed the XPath implementation in CVS to not call the *printf functions
if the number is actually an integer value, the current implementation was
bugged in this respect but only when the locale was influencing the behaviour
of the libc function. It's still mysterious to me whether the glibc is
actually at fault here. I prefer to not even take the risk to rely on 
those for integer formatting.

 I still don't understand either why this occured only in the context of
scrollkeeper, maybe it does some locale based tweaking, anyway this should
not influence the XPath serialization of integers.

http://cvs.gnome.org/bonsai/cvsquery.cgi?module=gnome-xml&branch=HEAD&branchtype=match&dir=gnome-xml&file=&filetype=match&who=veillard&whotype=match&sortby=Date&hours=&date=explicit&mindate=03%2F19%2F02+06%3A24&maxdate=03%2F19%2F02+06%3A26&cvsroot=%2Fcvs%2Fgnome

  Thanks for providing the testcase !

Daniel

  
-- 
Daniel Veillard      | Red Hat Network https://rhn.redhat.com/
vei...@re...  | libxml GNOME XML XSLT toolkit  http://xmlsoft.org/
http://veillard.com/ | Rpmfind RPM search engine http://rpmfind.net/

[Scrollkeeper-devel] Re: scrollkeeper_example2 0.1.0 Released

[Dan M. <mu...@al...>]

On Mon, 18 Mar 2002, John Fleck wrote:

> Dan -
> 
> Thanks for doing this. It seems simpler.
> 
> So if I understand correctly, the main changes I would need to make in
> existing and/or future packages would be:
> 
> 1) no longer list all figures, just the "figdir"?
> 2) use new xmldocs.make and include omf.make in the root (unless/until
> we've got Jody's centralized version in place.)?
> 3) get rid of omf-install directory?

Yes, those are the main changes.  There are also small changes to 
configure.in, the RPM spec file (if the package has one), and the 
Makefile.am's in the toplevel directory and doc/ directory (help/ 
directory in GNOME).  Also, we should make sure the OMF files have all the 
required bits.  This is outlined in the Writing ScrollKeeper OMF Files 
document at:

http://scrollkeeper.sourceforge.net/documentation/writing_scrollkeeper_omf_files/index.html

At a minimum, old OMF files will need a seriesid added to them, since this 
is a new feature in ScrollKeeper 0.3.x/0.4.x.  We should also check that 
all the documents have the right mime type, since most of them used to be 
"text/sgml" and now they are "text/xml".

Note that I will make a new package, gdp-example2, based off of 
scrollkeeper_example2 which has GNOME-specific customizations.  The 
differences will be very minor (just a couple paths changed probably), but 
it may be worth holding off updating lots of packages.

-Dan

  

[Scrollkeeper-devel] scrollkeeper_example2 0.1.1 Released

[Dan M. <mu...@al...>]

Scrollkeeper_example2 0.1.1 is now available.

New in this release:
        * Now works for srcdir!=builddir
        * Various documentation improvements
        * Document is indexed
        * A few small bug fixes

Scrollkeeper_example2 is an example package, illustrating how one can set
up a package to install XML documentation and OMF files and register them
with ScrollKeeper 0.3.x/0.4.x.  It includes Makefiles which can be
directly copied into place without any modifications for most packages. It
also includes a document which outlines how the package works and
enumerates the steps one follows to set up their own package similar to
this example package.

You can get scrollkeeper_example2 at:
        http://sourceforge.net/projects/scrollkeeper

Please send all comments and bugs to the scrollkeeper-devel mailing list,
me, or the bug tracker:
        http://sourceforge.net/tracker/?group_id=11543&atid=111543

Dan
mu...@al...

[Scrollkeeper-devel] Re: scrollkeeper_example2 0.1.0 Released

[John F. <jf...@in...>]

On Mon, Mar 18, 2002 at 02:04:07AM -0600, Dan Mueth wrote:
> 
> Scrollkeeper_example2 0.1.0 is now available.  This is the first release
> of scrollkeeper_example2.
> 
> Scrollkeeper_example2 is an example package, illustrating how one can set
> up a package to install XML documentation and OMF files and register them
> with ScrollKeeper 0.3.x/0.4.x.  It includes Makefiles which can be
> directly copied into place without any modifications for most packages. It
> also includes a document which outlines how the package works and
> enumerates the steps one follows to set up their own package similar to
> this example package.
> 
> Scrollkeeper_example2 is based off of Scrollkeeper_example1, but is
> modified to work with ScrollKeeper 0.3.x/0.4.x and has many other
> improvements.  Many of these improvements are based on feedback from
> users.  They include:
>   * The omf-install directory is no longer used.
>   * The main Makefiles no longer require any user customization
>   * Figures no longer need to be listed
>   * Much old cruft was removed from the Makefiles
>   * Fewer checks are necessary in configure.in
>   * A detailed list of steps are now listed in the documentation
>   * Packages no longer require ScrollKeeper as a dependency
> 

Dan -

Thanks for doing this. It seems simpler.

So if I understand correctly, the main changes I would need to make in
existing and/or future packages would be:

1) no longer list all figures, just the "figdir"?
2) use new xmldocs.make and include omf.make in the root (unless/until
we've got Jody's centralized version in place.)?
3) get rid of omf-install directory?

Cheers,

John

[Scrollkeeper-devel] scrollkeeper_example2 0.1.0 Released

[Dan M. <mu...@al...>]

Scrollkeeper_example2 0.1.0 is now available.  This is the first release
of scrollkeeper_example2.

Scrollkeeper_example2 is an example package, illustrating how one can set
up a package to install XML documentation and OMF files and register them
with ScrollKeeper 0.3.x/0.4.x.  It includes Makefiles which can be
directly copied into place without any modifications for most packages. It
also includes a document which outlines how the package works and
enumerates the steps one follows to set up their own package similar to
this example package.

Scrollkeeper_example2 is based off of Scrollkeeper_example1, but is
modified to work with ScrollKeeper 0.3.x/0.4.x and has many other
improvements.  Many of these improvements are based on feedback from
users.  They include:
  * The omf-install directory is no longer used.
  * The main Makefiles no longer require any user customization
  * Figures no longer need to be listed
  * Much old cruft was removed from the Makefiles
  * Fewer checks are necessary in configure.in
  * A detailed list of steps are now listed in the documentation
  * Packages no longer require ScrollKeeper as a dependency

You can get scrollkeeper_example2 at:
        http://sourceforge.net/projects/scrollkeeper

Please send all comments and bugs to the scrollkeeper-devel mailing list,
me, or the bug tracker:
        http://sourceforge.net/tracker/?group_id=11543&atid=111543

Dan
mu...@al...