{ "id": "62327", "key": "TIMOB-1695", "fields": { "issuetype": { "id": "1", "description": "A problem which impairs or prevents the functions of the product.", "name": "Bug", "subtask": false }, "project": { "id": "10153", "key": "TIMOB", "name": "Titanium SDK/CLI", "projectCategory": { "id": "10100", "description": "Titanium and related SDKs used in application development", "name": "Client" } }, "fixVersions": [], "resolution": { "id": "5", "description": "All attempts at reproducing this issue failed, or not enough information was available to reproduce the issue. Reading the code produces no clues as to why this behavior would occur. If more information appears later, please reopen the issue.", "name": "Cannot Reproduce" }, "resolutiondate": "2012-07-25T18:00:27.000+0000", "created": "2011-04-15T02:59:47.000+0000", "priority": { "name": "Trivial", "id": "5" }, "labels": [ "apidoc", "docgen.py" ], "versions": [], "issuelinks": [], "assignee": { "name": "nwright", "key": "nwright", "displayName": "Nolan Wright", "active": false, "timeZone": "America/Los_Angeles" }, "updated": "2012-07-25T18:00:27.000+0000", "status": { "description": "The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.", "name": "Closed", "id": "6", "statusCategory": { "id": 3, "key": "done", "colorName": "green", "name": "Done" } }, "components": [ { "id": "10206", "name": "iOS", "description": "iOS Platform" } ], "description": "{html}

While attempting to confirm my formatting in a patch for API\ndocs, I ran the output generation script docgen.py; to my surprise,\nthis has a hardcoded output path of\n~/work/appcelerator_network/new/public/devcenter/application/apidoc/mobile/1.4,\nwhich is not mentioned while running the script and can only be\nchanged by modifying the script's source code:

\n
\nif __name__ == \"__main__\":\n#   main(sys.argv)\n#   main([sys.argv[0],'json','output=~/tmp/doc'])   \n#   main([sys.argv[0],'devhtml','output=~/work/appcelerator_network/new/public/devcenter/application/apidoc/mobile/1.0.0'])\n    main([sys.argv[0],'devhtml','version=1.4','output=~/work/appcelerator_network/new/public/devcenter/application/apidoc/mobile/1.4'])\n#   main([sys.argv[0],'devhtml','colorize','css=page.css','output=~/work/titanium_mobile/demos/KitchenSink_iPad/Resources/apidoc'])\n
\n

The output format and directory should be settable as\ncommand-line options, and should either have a clearer default or\nrequire that an explicit value be set when running.

\n

Assigning to our support contact. (Nolan, is there someone in\ncharge of API documentation that we should assign these to more\ndirectly? Thanks!)

{html}", "attachment": [], "flagged": false, "summary": "docgen.py hardcodes output path to ~/work/appcelerator_network/new/public/devcenter/application...", "creator": { "name": "brionvibber", "key": "brionvibber", "displayName": "Brion Vibber", "active": true, "timeZone": "America/Los_Angeles" }, "subtasks": [], "reporter": { "name": "brionvibber", "key": "brionvibber", "displayName": "Brion Vibber", "active": true, "timeZone": "America/Los_Angeles" }, "environment": null, "comment": { "comments": [ { "id": "209501", "author": { "name": "stephentramer", "key": "stephentramer", "displayName": "Stephen Tramer", "active": true, "timeZone": "America/Los_Angeles" }, "body": "Cannot reproduce with 2.2.0.014b86f.\r\n\r\nTested via:\r\n\r\n{code}\r\nstiv@Tusk.local [05:58] in [~/src/appcelerator/titanium_mobile_origin]\r\ngit@[master:014b86f] ⤅ ∃? % ack 'work/appcelerator_network' apidoc/ \r\nstiv@Tusk.local [05:58] in [~/src/appcelerator/titanium_mobile_origin]\r\n{code}", "updateAuthor": { "name": "stephentramer", "key": "stephentramer", "displayName": "Stephen Tramer", "active": true, "timeZone": "America/Los_Angeles" }, "created": "2012-07-25T18:00:27.000+0000", "updated": "2012-07-25T18:00:27.000+0000" } ], "maxResults": 1, "total": 1, "startAt": 0 } } }