Блог

Я пытаюсь использовать defproc для форматирования определения функции (не для документирования библиотеки). Приведенный ниже код обеспечивает правильное форматирование, но выводит на консоль уродливое предупреждение при запуске Scribble:

 #lang scribble/manual
@require[(for-label racket/contract)]

@defproc[(f [x integer?]) integer?]{
  The best @racket[f].
}
  

Запуск scribble --html example.scrbl печатает:

 example.scrbl:4:10: WARNING: no declared exporting libraries for definition
  in: f
  

Есть ли какой-либо способ использовать defproc для форматирования и удалить сообщение об ошибке?

ДА. Добавьте необязательный аргумент #:link-target? #f , чтобы сообщить о своей цели.

 #lang scribble/manual
@require[(for-label racket/contract)]

@defproc[#:link-target? #f
         (f [x integer?]) integer?]{
  The best @racket[f].
}