Support multiple files with the same name.

[karlspalding]

Fixes #223.

Previously, if two or more files had the same base filename
only one would be documented. The others would be overwritten.

This patch replicates the structure of the source tree in the
document output tree to allow source files with the same
name but different paths.

[keithamus]

This should be behind a command line switch, because some people desire having a flat doc tree, and this would be a breaking change for those people.

[jashkenas]

This should be behind a command line switch

That doesn't sound very quick-and-dirty now, does it?

Instead, it would be nice to leave things flat, but prefix duplicate file names with their relative path as a qualification.

[keithamus]

Sorry @jashkenas, just concerned about users who currently expect a flat structure

[rudijs]

Hi,

I just ran into this problem too.

I'm new to Docco and I found it overwrites files with the same name today.

Example:

% grunt docs|grep articles
docco: app/controllers/articles.js -> docs/docco/articles.html
docco: config/routes/articles.js -> docs/docco/articles.html

Using:

% docco --version
0.6.2

I want to use Docco as other options are all way more complicated than I really need.

I guess moving forward I'll need to re-factor files name in the above example to something like:

app/controllers/articlesController.js
config/routes/articlesRoutes.js

I guess main benefit is all articles docs will group together in the flat structure Docco output folder.

I was assuming they'd not overwrite but that's fine.

Thanks.

[yuku]

I ran into the same problem.

[keithamus]

@karlspalding could you please rebase this, then I'll take another look. Thanks 😄

[shadowhand]

+1 I would very much like support for this.

[yanfali]

👍 Is this going to be in the 0.6.4 release?

[senica]

This is much needed. Large project have too many conflicting names to have only names in a flat directory structure.

[joseph-jja]

I got tired of waiting and created my own fork of grunt-docco, so if you are using grunt

https://www.npmjs.org/package/grunt-docco-dir

[smmoosavi]

+1

[voronianski]

+1

[keithamus]

Unfortunately we can't merge this until @karlspalding rebases against master. Alternatively, anyone else is welcome to take @karlspalding's implementation and update it in a new PR 😄.

[chiefjester]

@keithamus I took a stab on getting this PR's commit and rebasing it with the current master. Tested in my local and it works #336. Let me know if I need to change the commit attribution, since afterall it was @karlspalding 's original PR.

[joaomilho]

any update on this one? seems to me very important given all the "index.js" modern front end projects have

[cvega]

+1