helambdap-help — The HELambdaP "help" mailing list.

[HELambdaP-help] bug? incorrect link to dictionary

[Mirko V. <mir...@gm...>]

When HeLambdaP generates the documentation, the index.html file contains a
link to the dictionary like so:

(asdf:system-source-directory)/docs/dictionary/dictionary.html

whereas dictionary.html resides in

(asdf:system-source-directory)/docs/html/dictionary/dictionary.html

Mirko

[HELambdaP-help] bug or feature?: Functions without doc string are not documented

[Mirko V. <mir...@gm...>]

Hello,

I have a file with the following two function definitions:

(defun foo (arg)
  "Test function, returns NIL"
  nil)

(defun bar (arg)
  arg
  arg)

Only foo will be documented.  Bar stays undocumented until I add a
documentation string.  Even an empty string will be enough to trigger the
documentation.

My reading of the documentation leads me to believe that the syntax and
arguments and values sections should be generated.

Mirko

[HELambdaP-help] Handling filenames with reserved pathname characters

[Mirko V. <mir...@gm...>]

This is on Windows 10, Slime, CCL, and HeLambaP installed via quicklisp.

In one of my libraries, I have a function named "segment<="

The "<" character causes problems when the function documentation is
generated in "Function-SEGMENT<=.html".

"<" is a reserved character on
Windows (see
https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx
)

I can see various ways out of this, but I'll wait for the developer's
response.

Mirko

[HELambdaP-help] helambdap fails on itself while considering helambap.system

[Mirko V. <mir...@gm...>]

Hello,

The following is on CCL, Windows 10, Slime.

I exercised helambdap, installed the package via quicklisp into
helambdap-20160531-git from its installation directory like so:

(helambdap:document #P"" :documentation-title "HeLambdaP")

The code crashes while parsing helambdap.system with a missing method error:

There is no applicable method for the generic function:
  #<STANDARD-GENERIC-FUNCTION
|IT.UNIMIB.DISCO.MA.CL.HELambdaP|:EXTRACT-FORM-DOCUMENTATION #x2101CCA4EF>
when called with arguments:
  (#1=(:FILE "helambdap-pkg")
   (#1#
    (:FILE "helambdap-globals" :DEPENDS-ON ("helambdap-pkg"))
    (:MODULE "utilities" :DEPENDS-ON ("helambdap-pkg")
     :COMPONENTS
     ("text-utilities" "filename-utilities" "time-utilities"
      "streams-utilities" "symbols-utilities"
      (:FILE "lambda-list-parsing")))
    (:FILE "naming" :DEPENDS-ON ("helambdap-pkg"))
    (:FILE "doc-bit" :DEPENDS-ON ("naming" "helambdap-globals"))
    (:FILE "extract-doc" :DEPENDS-ON ("doc-bit"))
    (:FILE "helambdap" :DEPENDS-ON ("doc-bit"))
    (:FILE "collect-documentation" :DEPENDS-ON ("doc-bit"))
    (:FILE "doc-structure" :DEPENDS-ON
     ("helambdap-pkg" "utilities"))
    (:FILE "documentation-production" :DEPENDS-ON
     ("impl-dependent" "doc-structure"))
    (:FILE "xhtml-common-definitions" :DEPENDS-ON
     ("helambdap-pkg"))
    (:FILE "xhtml-lambda-producer" :DEPENDS-ON
     ("doc-structure" "utilities" "documentation-production"
      "xhtml-common-definitions"))
    (:MODULE "impl-dependent" :DEPENDS-ON ("helambdap-pkg")
     :COMPONENTS ((:FILE "asdf-deps")))))

Thanks,

Mirko