That’s OK, I will just use a filter like this:
#!/bin/sh
NS=$(basename "$1")
NS=${NS%.*}
echo "namespace $NS {"
cat "$1"
echo "}"
On Mon, 25 Dec 2017 17:25:49 -0700 (MST)
Yannick Duchêne via Doxygen-users <doxygen-users@lists.sourceforge.net> wrote:
> Hi there,
>
> As I understand Doxygen, it favours namespaces. I’m documenting an
> application whose UI use JavaScript. I have a main file for each page. Each
> of these main files have homonyms function names. On of these functions is
> simply called `main`.
>
> Say I have `page1.js` to `page9.js `. From say `page1.js`, if I write `@ref
> #main`, it will link to that of `page9.js`, the same from `page2.js` and so
> on.
>
> Since I refers a lot to function/constant names from comments, that’s a
> important deal (function and constant names takes parts in sentences as
> verbs and words).
>
> My guess is that the file should be a namespace, but there is no proper
> namespace construct with JavaScript (I naively tried to add `@namespace` at
> the top of tiles, but does not change anything). The only way a kind of
> namespace may appears, is when a module is imported (new in ES6). Even so,
> the imported module does not belong to a namespace, it’s a simple JavaScript
> file with just optional `export` keywords and `import`. So I have to do
> without namespaces. And anymway, these main files are not to be imported.
>
> The C world is used to circumvent the lack of modularity, giving unique
> names to each things. But there are statics in C and a C application may be
> complied using different file providing similar functions with equal names.
> So that’s not really a JavaScript specific issue.
>
> May be I could wrap everything in classes, but I don’t enjoy the idea of
> this kind of modifications just to circumvent this (I don’t mind tweaking
> the source to please Doxygen, but not this level of modifications). And a
> class has a meaning, an intent (ex. it has a constructor, to return multiple
> instances), it’s not to be used everywhere or for no good technical reasons.
>
> I wonder if and how some people found their way with this, either with
> JavaScript or C, since I feel to guess a solution for C could be applicable
> to JavaScript.
>
> if that matters, the application also uses Python, even more than
> JavaScript, so the Doxyfile is configured to optimize for Java, which is
> what’s recommended for Python. Is there a risk optimizing for Java prevents
> me from finding a proper solution?
>
> Have a merry Christmas as much as you can …
>
>
>
> --
> Sent from: http://doxygen.10944.n7.nabble.com/Doxygen-Users-f3.html
>
> ------------------------------------------------------------------------------
> Check out the vibrant tech community on one of the world's most
> engaging tech sites, Slashdot.org! http://sdm.link/slashdot
> _______________________________________________
> Doxygen-users mailing list
> Doxygen-users@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
--
Yannick Duchêne
------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
