[jira] [Commented] (MADLIB-1263) Doc: Multiple warnings

["Domino Valdano (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/MADLIB-1263?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16575530#comment-16575530 ] 

Domino Valdano commented on MADLIB-1263:
----------------------------------------

There are 604 warnings I get when running "make doc" on my machine. Here is a categorization of the types of warnings that show up, ranked by frequency of occurrence in the output (some of the ones left over in MISCELLANEOUS occur at least twice, just too lazy to finish categorizing all of them):
 * 243 multiple use of section label {}
 * 99 argument {} is not found in the argument list of {}
 * 91 unsupported tag {}
 * 59 the following parameters {} are not documented
 * 52 explicit link request {} cannot be resolved
 * 18 tag {} without matching end tag {}
 * 9 unexpected tag {}
 * 7 found unknown command {}
 * 5 lonely <li> tag found
 * 3 syntax error
 * 2 Tag {} has become obselete
 * 2 Tag {} belongs to an option that was not enabled at compile time
 * 14 MISCELLANEOUS

Fixing all of them would probably not be worth it, but perhaps we could just fix some of the more common ones, to reduce the volume of warnings reported.

> Doc: Multiple warnings
> ----------------------
>
>                 Key: MADLIB-1263
>                 URL: https://issues.apache.org/jira/browse/MADLIB-1263
>             Project: Apache MADlib
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Rahul Iyer
>            Assignee: Rahul Iyer
>            Priority: Minor
>             Fix For: v1.15.1
>
>         Attachments: make_doc_output.txt
>
>
> {{make doc}} results in multiple warnings (see attached file). 



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)