{"action":"created","issue":{"url":"https://api.github.com/repos/asciidoc/asciidoc/issues/44","labels_url":"https://api.github.com/repos/asciidoc/asciidoc/issues/44/labels{/name}","comments_url":"https://api.github.com/repos/asciidoc/asciidoc/issues/44/comments","events_url":"https://api.github.com/repos/asciidoc/asciidoc/issues/44/events","html_url":"https://github.com/asciidoc/asciidoc/issues/44","id":47265233,"number":44,"title":"a2x --destination-dir applies to man pages, too","user":{"login":"kdudka","id":227483,"avatar_url":"https://avatars.githubusercontent.com/u/227483?v=3","gravatar_id":"","url":"https://api.github.com/users/kdudka","html_url":"https://github.com/kdudka","followers_url":"https://api.github.com/users/kdudka/followers","following_url":"https://api.github.com/users/kdudka/following{/other_user}","gists_url":"https://api.github.com/users/kdudka/gists{/gist_id}","starred_url":"https://api.github.com/users/kdudka/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kdudka/subscriptions","organizations_url":"https://api.github.com/users/kdudka/orgs","repos_url":"https://api.github.com/users/kdudka/repos","events_url":"https://api.github.com/users/kdudka/events{/privacy}","received_events_url":"https://api.github.com/users/kdudka/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2014-10-30T12:44:33Z","updated_at":"2015-05-24T10:25:16Z","closed_at":null,"body":"I use a2x to generate a man page from an asciidoc text file. In asciidoc-8.6.8, the --destination-dir option of a2x was documented as \"Output directory.\" and it worked as documented. With asciidoc-8.6.9, the documentation says that the option \"is only applicable to HTML based output formats\".  The option continues to work with 8.6.9 as before, but a warning is printed: \"a2x: WARNING: --destination-dir option is only applicable to HTML based outputs\"\r\n\r\nLex Trotman says there is no such limitation in the current code and the warning message is wrong:\r\nhttps://groups.google.com/forum/#!topic/asciidoc/5ByGKFq1fMs"},"comment":{"url":"https://api.github.com/repos/asciidoc/asciidoc/issues/comments/104998772","html_url":"https://github.com/asciidoc/asciidoc/issues/44#issuecomment-104998772","issue_url":"https://api.github.com/repos/asciidoc/asciidoc/issues/44","id":104998772,"user":{"login":"elextr","id":811085,"avatar_url":"https://avatars.githubusercontent.com/u/811085?v=3","gravatar_id":"","url":"https://api.github.com/users/elextr","html_url":"https://github.com/elextr","followers_url":"https://api.github.com/users/elextr/followers","following_url":"https://api.github.com/users/elextr/following{/other_user}","gists_url":"https://api.github.com/users/elextr/gists{/gist_id}","starred_url":"https://api.github.com/users/elextr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/elextr/subscriptions","organizations_url":"https://api.github.com/users/elextr/orgs","repos_url":"https://api.github.com/users/elextr/repos","events_url":"https://api.github.com/users/elextr/events{/privacy}","received_events_url":"https://api.github.com/users/elextr/received_events","type":"User","site_admin":false},"created_at":"2015-05-24T10:25:16Z","updated_at":"2015-05-24T10:25:16Z","body":"Afraid I'm not latex literate so I don't know what dblatex is on about.\r\n\r\nBut, looking at the code of a2x I can't see where it uses `--destination-dir` when converting to PDF using dblatex.  So the option seems like it does not do anything, so the warning is valid.\r\n\r\nIronically it is used when converting PDF using FOP, but only for the intermediate result file of the XSLT step before FOP itself, since the XSLT step uses the same code as the HTML and manpage converters use, but `--destination-dir` is not used for the actual output file, so its not really the destination.\r\n\r\nSo I think the warning *is* correct for PDF outputs, though only partly so for FOP.\r\n\r\nFar be it for me to suggest that maybe your build script should not pass that option when building PDFs since it seems to be irrelevant. :)"}}