Source link doesn't include file name about codox

[weavejester]

Which version of Codox are you using?

[belucid]

0.6.6

project.clj is here: https://github.com/SnootyMonkey/Falkland-CMS/blob/master/project.clj

[belucid]

FWIW, I also tried it with 0.6.4, which was what hiccup is using, since I noticed their source links looked fine. I got the same result with 0.6.4.

[weavejester]

I took a closer look at your project.clj file. You've entered the wrong source path in your Codox setup. Rather than ["src"] or just leaving it blank, you've put in ["src/fcms/resources"] instead. Because it's a subdirectory of your source folder, Codox isn't able to resolve the paths.

Ideally this should raise an exception, but I don't think anyone's triggered this before.

[belucid]

Thanks! You're right, that worked just fine with this conf:

  :codox {
    :include [fcms.resources.common fcms.resources.collection fcms.resources.item fcms.resources.taxonomy]
    :output-dir "../Falkland-CMS-docs/API/Clojure"
    :src-dir-uri "http://github.com/SnootyMonkey/Falkland-CMS/blob/master/"
    :src-linenum-anchor-prefix "L" ; for Github
  }

I thought I'd discovered a nifty feature by setting sources to "src/fcms/resources" I was able to specify that I wanted docs for just that dir and didn't need each namespace individually.

With that config, I didn't need to worry about forgetting to add it to codox when I added a namespace. It effectively let me scope the docs to all the namespaces in the dir.

Such a config would be desirable :-)