Tcl Library Source Code

View Ticket
Login
Ticket UUID: 4aeded587b48cd96183e14c97607c5ab3913364a
Title: https://core.tcl.tk/tcllib/doc/trunk/embedded/www/tcllib/files/modules/asn/asn.html
Type: Bug Version:
Submitter: anonymous Created on: 2018-06-29 15:15:47
Subsystem: asn Assigned To: aku
Priority: 5 Medium Severity: Minor
Status: Pending Last Modified: 2018-07-10 13:11:39
Resolution: None Closed By: aku
    Closed on: 2018-07-09 17:07:24
Description:

The Example section references the Examples of the ldap package as an example. However the current version of the ldap package has no use of the asn package within the Example set.

See references:

https://core.tcl.tk/tcllib/doc/trunk/embedded/www/tcllib/files/modules/asn/asn.html https://core.tcl.tk/tcllib/doc/trunk/embedded/www/tcllib/files/modules/ldap/ldap.html

User Comments: anonymous added on 2018-07-10 13:11:39:

> Looking at the referenced asn doc page the relevant sentence in the example section says `found in the implementation of`. I.e. the code of ldap makes use of the asn package and command.

That is just plain ignorant documentation. The link pointed to in that quoted sentence is `https://core.tcl.tk/tcllib/doc/trunk/embedded/www/tcllib/files/modules/ldap/ldap.html` which is the documentation for ldap and not the implementation of the asn code in the repository. Something needs to change to show an example on the documentation page.


aku added on 2018-07-09 17:07:24:
>The Example section references the Examples of the ldap package as an example

I do not see that, with apologies.

Looking at the referenced asn doc page the relevant sentence in the example section says `found in the implementation of`. I.e. the code of ldap makes use of the asn package and command.

And I have now confirmed that this is indeed (still) true.

So, this report looks invalid to me.

Even so, thank you for reporting, and please continue reporting things you believe are trouble.