1. Forum
  2. Usenet
  3. LINUX.DEBIAN.BUGS.DIST

  • Bug#265746: acknowledged by developer (Bug#265746: fixed in jakarta-log

    From Marco Nenciarini@1:229/2 to Debian Bug Tracking System on Mon Aug 16 17:30:15 2004
    From: [email protected]

    reopen 265746
    thanks

    On Sun, Aug 15, 2004 at 05:03:14AM -0700, Debian Bug Tracking System wrote:
    This is an automatic notification regarding your Bug report
    #265746: liblog4j1.2-java-doc: javadoc section is empty,
    which was filed against the liblog4j1.2-java-doc package.

    Now, all */classes.html (not /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/config/classes.html)
    are missed because all /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/*
    directory (excluding config) contain javadoc generated documentation.

    The following files are 0 sized: /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/helpers/BoundedFIFO.html
    /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/package-summary.html

    /usr/share/doc/liblog4j1.2-java-doc/docs/api/fulltree.html
    report empty list.

    The following files contains only the xml declaration: /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/WriterAppender.html
    /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/TTCCLayout.html /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/MDC.html /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/PatternLayout.html
    /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/Priority.html /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/Level.html /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/AppenderSkeleton.html
    /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/Hierarchy.html /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/RollingFileAppender.html
    /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j/ConsoleAppender.html

    Other html files in /usr/share/doc/liblog4j1.2-java-doc/docs/api/org/apache/log4j
    directory are allmost completely useless.

    API documentation still unusable.

    please consider to distribute original documentation instead of Gjdoc
    generated version.

    regards

    --
    ---------------------------------------------------------------------
    | Marco Nenciarini | Debian/GNU Linux Developer - Plug Member |
    | [email protected] | http://www.prato.linux.it/~mnencia | ---------------------------------------------------------------------
    Key fingerprint = FED9 69C7 9E67 21F5 7D95 5270 6864 730D F095 E5E4


    -----BEGIN PGP SIGNATURE-----
    Version: GnuPG v1.2.4 (GNU/Linux)

    iD8DBQFBIM42aGRzDfCV5eQRAl18AJsHyr7aJGvRPxy0c93SwIHIyNtCgwCePVwf /EmvOYTCSmS30wXuIVhLS+4=
    =vhdG
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)
  • From Arnaud Vandyck@1:229/2 to Marco Nenciarini on Mon Aug 16 18:40:10 2004
    From: [email protected]

    Marco Nenciarini <[email protected]> writes:

    please consider to distribute original documentation instead of Gjdoc generated version.

    Maybe we can make an exception about this but it's a violation of the
    policy because if we cannot use gjdoc to build the javadoc, it means we
    have to use non-free javadoc tools and that means the package should go
    back to contrib.

    By the way, I'm not sure gjdoc will be fixed before Sarge release.

    Another way (but it'll take some time!) is to build the documentation
    with Doxygen or with another free tool.

    Cheers,

    --
    .''`.
    : :' :rnaud
    `. `'
    `-

    -----BEGIN PGP SIGNATURE-----
    Version: GnuPG v1.2.5 (GNU/Linux)

    iD8DBQBBIOCo4vzFZu62tMIRAogWAJ9bnw6DyXRnnuAxf6SyjBR/U3rbkQCgtxFd DD075h2GnWTqd8z5hHptHGc=
    =5Cy/
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)
  • From Kalle Kivimaa@1:229/2 to Arnaud Vandyck on Mon Aug 16 19:30:14 2004
    From: [email protected]

    Arnaud Vandyck <[email protected]> writes:
    Maybe we can make an exception about this but it's a violation of the
    policy because if we cannot use gjdoc to build the javadoc, it means we
    have to use non-free javadoc tools and that means the package should go
    back to contrib.

    Is it required by policy that the documentation must be buildable from
    source? :)

    --
    * Sufficiently advanced magic is indistinguishable from technology (T.P) *
    * PGP public key available @ http://www.iki.fi/killer *

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)
  • From Arnaud Vandyck@1:229/2 to Kalle Kivimaa on Tue Aug 17 14:00:16 2004
    From: [email protected]

    Kalle Kivimaa <[email protected]> writes:

    Arnaud Vandyck <[email protected]> writes:
    Maybe we can make an exception about this but it's a violation of the
    policy because if we cannot use gjdoc to build the javadoc, it means we
    have to use non-free javadoc tools and that means the package should go
    back to contrib.

    Is it required by policy that the documentation must be buildable from source? :)

    You are lucky!

    ,----[ /usr/share/doc/java-common/policy.txt.gz ]
    | Chapter 2. Policy
    |
    | [...]
    |
    | This policy does not yet address the issue of documentation
    | (for instance HTML pages made with javadoc).
    `----

    ;-)

    --
    Arnaud Vandyck
    http://fosdem.org/
    Free and Open Source Software Developers' Meeting
    February 26-27 2005,
    Bruxelles, Belgium

    -----BEGIN PGP SIGNATURE-----
    Version: GnuPG v1.2.5 (GNU/Linux)

    iD8DBQBBIe4h4vzFZu62tMIRAlVdAKChM3TG03u63wWnquKahqcF4bSovACgoRxV 05HnmX7SwQ1QhvVLJsDVrwk=
    =gtuN
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)
  • From Kalle Kivimaa@1:229/2 to Arnaud Vandyck on Tue Aug 17 14:20:07 2004
    From: [email protected]

    Arnaud Vandyck <[email protected]> writes:
    | This policy does not yet address the issue of documentation
    | (for instance HTML pages made with javadoc).

    In that case I will use the original javadocs as they are available in
    the upstream distribution, so I really don't see that as a DFSG
    violation.

    --
    * Sufficiently advanced magic is indistinguishable from technology (T.P) *
    * PGP public key available @ http://www.iki.fi/killer *

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)
  • From Arnaud Vandyck@1:229/2 to Kalle Kivimaa on Tue Aug 17 15:00:12 2004
    From: [email protected]

    Kalle Kivimaa <[email protected]> writes:

    Arnaud Vandyck <[email protected]> writes:
    | This policy does not yet address the issue of documentation
    | (for instance HTML pages made with javadoc).

    In that case I will use the original javadocs as they are available in
    the upstream distribution, so I really don't see that as a DFSG
    violation.

    Sight. Maybe we'll re-evaluate this when javadoc generation will be
    solved.

    --
    Arnaud Vandyck
    http://fosdem.org/
    Free and Open Source Software Developers' Meeting
    February 26-27 2005,
    Bruxelles, Belgium


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

    --- SoupGate-Win32 v1.05
    * Origin: you cannot sedate... all the things you hate (1:229/2)