692002 - api parse error message is not useful for `cfx docs`

Status: RESOLVED FIXED

(Add-on SDK Graveyard :: Documentation, defect)

Description

[Erik Vold]

I'm getting the following error message when I try to run cfx docs, unfortunately idk what file is causing the problems because the error message does not tell me. It would be nice if this error message included the problem file in the traceback someplace.

$ source bin/activate
Welcome to the Add-on SDK. Run 'cfx docs' for assistance.
(addon-sdk)$ cfx docs
Generating documentation...
Traceback (most recent call last):
  File "/github/addon-sdk/bin/cfx", line 29, in <module>
    cuddlefish.run()
  File "/github/addon-sdk/python-lib/cuddlefish/__init__.py", line 468, in run
    docs_home = generate.generate_docs(env_root)
  File "/github/addon-sdk/python-lib/cuddlefish/docs/generate.py", line 52, in generate_docs
    generate_docs_from_scratch(env_root, base_url, docs_dir)
  File "/github/addon-sdk/python-lib/cuddlefish/docs/generate.py", line 152, in generate_docs_from_scratch
    generate_file_tree(env_root, docs_src_dir, web_docs, generate_api_doc)
  File "/github/addon-sdk/python-lib/cuddlefish/docs/generate.py", line 169, in generate_file_tree
    generate_file(env_root, src_path, web_docs)
  File "/github/addon-sdk/python-lib/cuddlefish/docs/generate.py", line 179, in generate_api_doc
    docs_parsed = list(apiparser.parse_hunks(docs_md))
  File "/github/addon-sdk/python-lib/cuddlefish/docs/apiparser.py", line 269, in parse_hunks
    api, line_number = APIParser().parse(lines, line_number)
  File "/github/addon-sdk/python-lib/cuddlefish/docs/apiparser.py", line 113, in parse
    raise ParseError("closing </api> tag not found", lineno + 1)
cuddlefish.docs.apiparser.ParseError: ParseError: the JS API docs were unparseable on line 61: closing </api> tag not found

Comment 1

[Erik Vold]

Attachment: Pointer to Github pull request: https://github.com/mozilla/addon-sdk/pull/241

Pointer to Github pull-request

Comment 2

[Will Bamberg [:wbamberg]]

Comment on attachment 564739 [details]
Pointer to Github pull request: https://github.com/mozilla/addon-sdk/pull/241

Thanks Erik!

Comment 3

[Wes Kocher (:KWierso) (Not reading bugmail; email directly if needed)]

This landed already.