Menu

#2 DOCUMENT's incorrect error message about format

1.0
closed
None
2019-05-29
2018-05-18
mirko
No

If I specify a system by keyword (instead of path) in DOCUMENT, I get an error about unknown format. For example, this invocation

(document :snell :documentation-title "SnellDoc 5-18" :format 'html)

results in the error message

HELAMBDAP: unknown resulting documentation format HTML.
   [Condition of type SIMPLE-ERROR]

Restarts:
 0: [RETRY] Retry SLIME REPL evaluation request.
 1: [*ABORT] Return to SLIME's top level.
 2: [ABORT-BREAK] Reset this thread
 3: [ABORT] Kill this thread

Backtrace:
  0: (#<STANDARD-METHOD BUILD-DOCUMENTATION (T T)> :SNELL HTML)
  1: (CCL::%%STANDARD-COMBINED-METHOD-DCODE ((#<STANDARD-METHOD BUILD-DOCUMENTATION :BEFORE (T T)>) NIL #<STANDARD-METHOD BUILD-DOCUMENTATION (T T)>) 82260667)
  2: (NIL #<Unknown Arguments>)
  3: (DOCUMENT :SNELL :DOCUMENTATION-TITLE "SnellDoc 5-18" :FORMAT HTML :LAYOUT #<DOCUMENTATION-STRUCTURE #x2101FD209D> :SOURCE #P"" :DESTINATION #P"docs/html/" :SUPERSEDE T :ONLY-DOCUMENTED T :ONLY-EXPORT..
  4: (CCL::CALL-CHECK-REGS DOCUMENT :SNELL 

The problem goes away if I specify the system by its source directory like so:

(document (asdf:system-source-directory :snell) :documentation-title "SnellDoc 5-18" :format 'html)

Discussion

  • Marco Antoniotti

    Ok. I can add a catch all method on the first argument. I will not add a method that searched systems based on a keyword.

    The use will always have to be

    (document (find-system :snell) ...)
    

    Cheers
    Marco

     
  • mirko

    mirko - 2018-05-19

    OK by me.

     
  • Marco Antoniotti

    • status: open --> closed
    • assigned_to: Marco Antoniotti
     

Log in to post a comment.

MongoDB Logo MongoDB