* [ITP] DocBook 5 + tools
@ 2017-03-30 15:39 Holger Bast
2017-03-31 9:37 ` Aw: " Holger Bast
2017-04-05 17:05 ` Jon Turney
0 siblings, 2 replies; 7+ messages in thread
From: Holger Bast @ 2017-03-30 15:39 UTC (permalink / raw)
To: cygwin-apps
Hi there,
I'm interested in maintaining DocBook 5 schemata plus some additional tools for docbook (daps and jing-trang). I've never maintained a package before, so I think the best way for me would be starting with DocBook 5. By creating the cygport file I run into some questions that I would like to address:
1) docbook-5.0 installation path
All docbook-4.x files are installed in /usr/share/xml/docbook/<xml-dtd-4.5> and so on. With DocBook 5 the distribution format changed and there is now one folder with all necessary information:
drwx------+ 1 holger Kein 0 6. Feb 2008 .
drwx------+ 1 holger Kein 0 30. Mrz 16:39 ..
-rwx------+ 1 holger Kein 3287 6. Feb 2008 catalog.xml
-rwx------+ 1 holger Kein 46419 6. Feb 2008 ChangeLog
-rwx------+ 1 holger Kein 430 6. Feb 2008 docbook.nvdl
drwx------+ 1 holger Kein 0 6. Feb 2008 docs
drwx------+ 1 holger Kein 0 6. Feb 2008 dtd
-rwx------+ 1 holger Kein 1182 6. Feb 2008 README
drwx------+ 1 holger Kein 0 6. Feb 2008 rng
drwx------+ 1 holger Kein 0 6. Feb 2008 sch
drwx------+ 1 holger Kein 0 6. Feb 2008 tools
-rwx------+ 1 holger Kein 4 6. Feb 2008 VERSION
drwx------+ 1 holger Kein 0 6. Feb 2008 xsd
I propose to put the hole distribution under
/usr/share/xml/docbook/docbook-5.0/
so everything is in one place. I also had a look at Ubuntu; they put the schema-folders (dtd, rng, schematron (renamed sch), xsd and catalog-docbook5.xml) under
/usr/share/xml/docbook/schema
and all documentation in their doc-structure. In my opinion, putting everything at one place would be the easiest way to work with.
2) docbook.cyglass
Should I make use of the docbook.cyglass file? I think this one heavily depends on DocBook 4.x distribution.
Bye & thanks,
Holger
^ permalink raw reply [flat|nested] 7+ messages in thread
* Aw: [ITP] DocBook 5 + tools
2017-03-30 15:39 [ITP] DocBook 5 + tools Holger Bast
@ 2017-03-31 9:37 ` Holger Bast
2017-04-05 17:05 ` Jon Turney
1 sibling, 0 replies; 7+ messages in thread
From: Holger Bast @ 2017-03-31 9:37 UTC (permalink / raw)
To: cygwin-apps
category: Text
requires: perl
sdesc: "DocBook XML 5.0 distribution"
ldesc: "DocBook is a schema (available in several languages including RELAX NG, SGML and XML DTDs, and W3C XML Schema)
maintained by the DocBook Technical Committee of OASIS. It is particularly well suited to books and papers about
computer hardware and software (though it is by no means limited to these applications)."
http://packages.ubuntu.com/search?keywords=docbook5-xml
Packages:
https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1.hint
https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1.tar.xz
https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1-src.tar.xz
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [ITP] DocBook 5 + tools
2017-03-30 15:39 [ITP] DocBook 5 + tools Holger Bast
2017-03-31 9:37 ` Aw: " Holger Bast
@ 2017-04-05 17:05 ` Jon Turney
2017-04-05 19:12 ` Holger Bast
2017-04-07 10:14 ` Holger Bast
1 sibling, 2 replies; 7+ messages in thread
From: Jon Turney @ 2017-04-05 17:05 UTC (permalink / raw)
To: cygwin-apps; +Cc: Holger Bast
On 30/03/2017 16:39, Holger Bast wrote:
> Hi there,
> I'm interested in maintaining DocBook 5 schemata plus some additional tools for docbook (daps and jing-trang). I've never maintained a package before, so I think the best way for me would be starting with DocBook 5. By creating the cygport file I run into some questions that I would like to address:
Thanks for doing this.
For the avoidance of doubt, what license applies to this?
> 1) docbook-5.0 installation path
> All docbook-4.x files are installed in /usr/share/xml/docbook/<xml-dtd-4.5> and so on. With DocBook 5 the distribution format changed and there is now one folder with all necessary information:
>
[...]
>
> I propose to put the hole distribution under
>
> /usr/share/xml/docbook/docbook-5.0/
>
> so everything is in one place. I also had a look at Ubuntu; they put the schema-folders (dtd, rng, schematron (renamed sch), xsd and catalog-docbook5.xml) under
>
> /usr/share/xml/docbook/schema
>
> and all documentation in their doc-structure. In my opinion, putting everything at one place would be the easiest way to work with.
I think the documentation should be under /usr/share/doc, both to
conform with our packaging guidelines (such as they are), and for
discoverability (people may know to look in /usr/share/doc for
documentation)
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [ITP] DocBook 5 + tools
2017-04-05 17:05 ` Jon Turney
@ 2017-04-05 19:12 ` Holger Bast
2017-04-07 10:14 ` Holger Bast
1 sibling, 0 replies; 7+ messages in thread
From: Holger Bast @ 2017-04-05 19:12 UTC (permalink / raw)
To: cygwin-apps
Hello Jon,
thanks for your reply.
Jon Turney schrieb:
> On 30/03/2017 16:39, Holger Bast wrote:
>> Hi there,
>> I'm interested in maintaining DocBook 5 schemata plus some additional tools for docbook (daps and jing-trang). I've
>> never maintained a package before, so I think the best way for me would be starting with DocBook 5. By creating the
>> cygport file I run into some questions that I would like to address:
>
> Thanks for doing this.
>
> For the avoidance of doubt, what license applies to this?
DocBook is an open standard from OASIS.
>> 1) docbook-5.0 installation path
>> All docbook-4.x files are installed in /usr/share/xml/docbook/<xml-dtd-4.5> and so on. With DocBook 5 the distribution
>> format changed and there is now one folder with all necessary information:
>>
> [...]
I decided not to rely on the "old" docbook-4.x files and generate a new one. This package will not collide with any
docbook-4.x installation!
>>
>> I propose to put the hole distribution under
>>
>> /usr/share/xml/docbook/docbook-5.0/
>>
>> so everything is in one place. I also had a look at Ubuntu; they put the schema-folders (dtd, rng, schematron (renamed
>> sch), xsd and catalog-docbook5.xml) under
>>
>> /usr/share/xml/docbook/schema
>>
>> and all documentation in their doc-structure. In my opinion, putting everything at one place would be the easiest way
>> to work with.
>
> I think the documentation should be under /usr/share/doc, both to conform with our packaging guidelines (such as they
> are), and for discoverability (people may know to look in /usr/share/doc for documentation)
Ok. I'll check that tomorrow and update my package and recipe file :)
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [ITP] DocBook 5 + tools
2017-04-05 17:05 ` Jon Turney
2017-04-05 19:12 ` Holger Bast
@ 2017-04-07 10:14 ` Holger Bast
2017-04-18 14:05 ` [ITP] DocBook 5 + tools -- Next Steps? Holger Bast
1 sibling, 1 reply; 7+ messages in thread
From: Holger Bast @ 2017-04-07 10:14 UTC (permalink / raw)
To: cygwin-apps; +Cc: Jon Turney
Ok, I updated the files and uploaded them on the server.
1) License added
2) doc und xml files are now separated
category: Text
requires: perl
sdesc: "DocBook XML 5.0 distribution"
ldesc: "DocBook is a schema (available in several languages including RELAX NG, SGML and XML DTDs, and W3C XML Schema)
maintained by the DocBook Technical Committee of OASIS. It is particularly well suited to books and papers about
computer hardware and software (though it is by no means limited to these applications)."
http://packages.ubuntu.com/search?keywords=docbook5-xml
Packages:
https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1.hint
https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1.tar.xz
https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1-src.tar.xz
> Gesendet: Mittwoch, 05. April 2017 um 19:05 Uhr
> Von: "Jon Turney" <jon.turney@dronecode.org.uk>
> An: cygwin-apps@cygwin.com
> Cc: "Holger Bast" <HolgerBast@gmx.de>
> Betreff: Re: [ITP] DocBook 5 + tools
>
> On 30/03/2017 16:39, Holger Bast wrote:
> > Hi there,
> > I'm interested in maintaining DocBook 5 schemata plus some additional tools for docbook (daps and jing-trang). I've never maintained a package before, so I think the best way for me would be starting with DocBook 5. By creating the cygport file I run into some questions that I would like to address:
>
> Thanks for doing this.
>
> For the avoidance of doubt, what license applies to this?
>
> > 1) docbook-5.0 installation path
> > All docbook-4.x files are installed in /usr/share/xml/docbook/<xml-dtd-4.5> and so on. With DocBook 5 the distribution format changed and there is now one folder with all necessary information:
> >
> [...]
> >
> > I propose to put the hole distribution under
> >
> > /usr/share/xml/docbook/docbook-5.0/
> >
> > so everything is in one place. I also had a look at Ubuntu; they put the schema-folders (dtd, rng, schematron (renamed sch), xsd and catalog-docbook5.xml) under
> >
> > /usr/share/xml/docbook/schema
> >
> > and all documentation in their doc-structure. In my opinion, putting everything at one place would be the easiest way to work with.
>
> I think the documentation should be under /usr/share/doc, both to
> conform with our packaging guidelines (such as they are), and for
> discoverability (people may know to look in /usr/share/doc for
> documentation)
>
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [ITP] DocBook 5 + tools -- Next Steps?
2017-04-07 10:14 ` Holger Bast
@ 2017-04-18 14:05 ` Holger Bast
2017-04-19 16:16 ` Jon Turney
0 siblings, 1 reply; 7+ messages in thread
From: Holger Bast @ 2017-04-18 14:05 UTC (permalink / raw)
To: cygwin-apps
Hi there,
Are the packages docbook5 and daps ok and will they be included in the cygwin portage?
What are the next steps for me?
Thx + Bye,
Holger
> Gesendet: Freitag, 07. April 2017 um 12:13 Uhr
> Von: "Holger Bast" <HolgerBast@gmx.de>
> An: cygwin-apps@cygwin.com
> Cc: "Jon Turney" <jon.turney@dronecode.org.uk>
> Betreff: Re: [ITP] DocBook 5 + tools
>
> Ok, I updated the files and uploaded them on the server.
> 1) License added
> 2) doc und xml files are now separated
>
>
>
> category: Text
> requires: perl
> sdesc: "DocBook XML 5.0 distribution"
> ldesc: "DocBook is a schema (available in several languages including RELAX NG, SGML and XML DTDs, and W3C XML Schema)
> maintained by the DocBook Technical Committee of OASIS. It is particularly well suited to books and papers about
> computer hardware and software (though it is by no means limited to these applications)."
>
> http://packages.ubuntu.com/search?keywords=docbook5-xml
>
> Packages:
> https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1.hint
> https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1.tar.xz
> https://virtualheadcrash.net/cygwin/x86/docbook-5.0/docbook-5-5.0-1-src.tar.xz
>
>
>
>
> > Gesendet: Mittwoch, 05. April 2017 um 19:05 Uhr
> > Von: "Jon Turney" <jon.turney@dronecode.org.uk>
> > An: cygwin-apps@cygwin.com
> > Cc: "Holger Bast" <HolgerBast@gmx.de>
> > Betreff: Re: [ITP] DocBook 5 + tools
> >
> > On 30/03/2017 16:39, Holger Bast wrote:
> > > Hi there,
> > > I'm interested in maintaining DocBook 5 schemata plus some additional tools for docbook (daps and jing-trang). I've never maintained a package before, so I think the best way for me would be starting with DocBook 5. By creating the cygport file I run into some questions that I would like to address:
> >
> > Thanks for doing this.
> >
> > For the avoidance of doubt, what license applies to this?
> >
> > > 1) docbook-5.0 installation path
> > > All docbook-4.x files are installed in /usr/share/xml/docbook/<xml-dtd-4.5> and so on. With DocBook 5 the distribution format changed and there is now one folder with all necessary information:
> > >
> > [...]
> > >
> > > I propose to put the hole distribution under
> > >
> > > /usr/share/xml/docbook/docbook-5.0/
> > >
> > > so everything is in one place. I also had a look at Ubuntu; they put the schema-folders (dtd, rng, schematron (renamed sch), xsd and catalog-docbook5.xml) under
> > >
> > > /usr/share/xml/docbook/schema
> > >
> > > and all documentation in their doc-structure. In my opinion, putting everything at one place would be the easiest way to work with.
> >
> > I think the documentation should be under /usr/share/doc, both to
> > conform with our packaging guidelines (such as they are), and for
> > discoverability (people may know to look in /usr/share/doc for
> > documentation)
> >
> >
>
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [ITP] DocBook 5 + tools -- Next Steps?
2017-04-18 14:05 ` [ITP] DocBook 5 + tools -- Next Steps? Holger Bast
@ 2017-04-19 16:16 ` Jon Turney
0 siblings, 0 replies; 7+ messages in thread
From: Jon Turney @ 2017-04-19 16:16 UTC (permalink / raw)
To: cygwin-apps; +Cc: Holger Bast
On 18/04/2017 15:05, Holger Bast wrote:
> Hi there,
> Are the packages docbook5 and daps ok and will they be included in the cygwin portage?
>
> What are the next steps for me?
Thank you for your patience and sorry about the delay.
Sorry I didn't notice this before, but I think this package should be
called 'docbook5' (there are no current examples of a package name
containing a hyphen followed by a digit, and I think that should be
avoided), in which case, the cygport file should be named docbook5.cygport
Your .cygport file also has a mixture of tabs and spaces, please fix that.
With those things fixed, package looks good, so please provide a ssh key
as per https://cygwin.com/package-upload.html
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2017-04-19 16:16 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-03-30 15:39 [ITP] DocBook 5 + tools Holger Bast
2017-03-31 9:37 ` Aw: " Holger Bast
2017-04-05 17:05 ` Jon Turney
2017-04-05 19:12 ` Holger Bast
2017-04-07 10:14 ` Holger Bast
2017-04-18 14:05 ` [ITP] DocBook 5 + tools -- Next Steps? Holger Bast
2017-04-19 16:16 ` Jon Turney
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).