Bug#472501: doc-base: Please add the Programming/OCaml section

2008-03-28 Thread Robert Luberda
Stefano Zacchiroli writes:

Hi,

 On Mon, Mar 24, 2008 at 06:33:08PM +0100, Samuel Mimram wrote:
 It would be nice if you could allow the Programming/OCaml section. There
 are many OCaml libraries in Debian and having all their doc registered
 in the same section would be useful.
 
 Seconded.

Programming/OCaml is a valid section. Quoting the section 2.3.3 of
doc-base manual:

  Programming
IDEs, debuggers, compilers, APIs, libraries, programming languages.
Documentation related to only one specific language should be put in
subsection named like the language, for example:
*  C
*  C++
*  Java
*  Perl
*  Python
*  Ruby

The list contains only examples and is not (and most probably never be)
complete. I can add OCaml to it in the next release.

 
 While we are at it, can the doc-base maintainer please comment on
 whether the sections Programming/Foo are appropriate for library
 documentation automatically generated by some literate programming tool
 (ocamldoc in our case, but more generally also javadoc, pydoc, ...).

Obviously! APIs of language Foo, even automatically generated, should go
to Programming/Foo.


Regards,
robert





-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Bug#472501: doc-base: Please add the Programming/OCaml section

2008-03-24 Thread Samuel Mimram
Package: doc-base
Version: 0.8.10
Severity: wishlist

Hi,

It would be nice if you could allow the Programming/OCaml section. There
are many OCaml libraries in Debian and having all their doc registered
in the same section would be useful.

Thanks!

-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (1, 'experimental')
Architecture: i386 (i686)

Kernel: Linux 2.6.24-1-686 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL 
set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages doc-base depends on:
ii  perl  5.8.8-12   Larry Wall's Practical Extraction 
ii  scrollkeeper  0.3.14-16  A free electronic cataloging syste

doc-base recommends no packages.

-- no debconf information



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Bug#472501: doc-base: Please add the Programming/OCaml section

2008-03-24 Thread Stefano Zacchiroli
On Mon, Mar 24, 2008 at 06:33:08PM +0100, Samuel Mimram wrote:
 It would be nice if you could allow the Programming/OCaml section. There
 are many OCaml libraries in Debian and having all their doc registered
 in the same section would be useful.

Seconded.

While we are at it, can the doc-base maintainer please comment on
whether the sections Programming/Foo are appropriate for library
documentation automatically generated by some literate programming tool
(ocamldoc in our case, but more generally also javadoc, pydoc, ...).

If it is not please point us to the appropriate sub-section.

Many thanks in advance,
Cheers.

-- 
Stefano Zacchiroli -*- PhD in Computer Science ... now what?
[EMAIL PROTECTED],cs.unibo.it,debian.org}  -%-  http://upsilon.cc/zack/
(15:56:48)  Zack: e la demo dema ?/\All one has to do is hit the
(15:57:15)  Bac: no, la demo scema\/right keys at the right time


signature.asc
Description: Digital signature