Re: [racket-users] Scribble warnings in package documentation

2018-10-06 Thread Matthew Flatt
Are you still seeing this problem? It looks like multiple problems,
possibly these:

 - `@defmodule[appy]` appearing in multiple sections

This one might be fixed by putting it once at a section that
encloses others, or maybe by using `#:link-target? #f` on all
but once of them.

 - function definitions in sections that are not within one that has
   `@defmodule[appy]`

   This one might also be fixed by moving `@defmodule[appy]` to an
   enclosing section, or maybe by just using
   `@declare-exporting[appy]`.

 -  Multiple sections titled "Overview".

This would be fixed by adding a `#:tag` to one or more of them to
make them distinct.

At Wed, 26 Sep 2018 16:09:56 +0100, Erich Rast wrote:
> I have a long package documentation and get lots of warnings - see
> below. Other than that, the docs work fine, should/can I ignore them? 
> 
> What do they mean anyway?
> 
> Best,
> 
> Erich
> 
> WARNING: collected information for key multiple times: '(exporting-libraries 
> #f); values: '(appy/gui) '(appy)
> WARNING: collected information for key multiple times: '(exporting-packages 
> #f); values: '("appy") '("appy")
> WARNING: collected information for key multiple times: '(exporting-libraries 
> #f); values: '(appy/storage-interface) '(appy/storage)
> WARNING: collected information for key multiple times: '(exporting-packages 
> #f); values: '("appy") '("appy")
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: no declared exporting libraries for definition
> WARNING: collected information for key multiple times: '(index-entry (part 
> "Overview")); values: (list '("Overview") (list (element #f '("Overview"))) 
> (part-index-desc)) (list '("Overview") (list (element #f '("Overview"))) 
> (part-index-desc))
> WARNING: collected information for key multiple times: '(part "Overview"); 
> values: '#(("Overview") (part "Overview") (1) (collects #"appy" 
> #"scribblings" 
> #"manual.html") #f) '#(("Overview") (part "Overview") (1 4 2) (collects 
> #"appy" #"scribblings" #"manual.html") #f)
> 
> -- 
> You received this message because you are subscribed to the Google Groups 
> "Racket Users" group.
> To unsubscribe from this group and stop receiving emails from it, send an 
> email to racket-users+unsubscr...@googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.


[racket-users] Scribble warnings in package documentation

2018-09-26 Thread Erich Rast
I have a long package documentation and get lots of warnings - see
below. Other than that, the docs work fine, should/can I ignore them? 

What do they mean anyway?

Best,

Erich

WARNING: collected information for key multiple times: '(exporting-libraries 
#f); values: '(appy/gui) '(appy)
WARNING: collected information for key multiple times: '(exporting-packages 
#f); values: '("appy") '("appy")
WARNING: collected information for key multiple times: '(exporting-libraries 
#f); values: '(appy/storage-interface) '(appy/storage)
WARNING: collected information for key multiple times: '(exporting-packages 
#f); values: '("appy") '("appy")
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: no declared exporting libraries for definition
WARNING: collected information for key multiple times: '(index-entry (part 
"Overview")); values: (list '("Overview") (list (element #f '("Overview"))) 
(part-index-desc)) (list '("Overview") (list (element #f '("Overview"))) 
(part-index-desc))
WARNING: collected information for key multiple times: '(part "Overview"); 
values: '#(("Overview") (part "Overview") (1) (collects #"appy" #"scribblings" 
#"manual.html") #f) '#(("Overview") (part "Overview") (1 4 2) (collects #"appy" 
#"scribblings" #"manual.html") #f)

-- 
You received this message because you are subscribed to the Google Groups 
"Racket Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to racket-users+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.