search

defold / defold.github.io

www.defold.com
Other
11 stars 15 forks source link

Separate concept of "namespace" and file name #31

Open JCash opened 4 years ago

JCash commented 4 years ago

Currently multiple documents cannot share the same "@namespace". If they do, only one of these "@document" tags' info will be added. And, since a document has a separate include file path, this gets wrong quickly.

E.g. hash.h and dstrings.h both reside in the global namespace, but you need two different includes to use these functions.

britzl commented 4 years ago

I'm not sure I understand the problem. Can you please elaborate?

JCash commented 4 years ago

For instance, there is no namespace called "dmStringFunc", yet, we call it that, and the file link is named "dmStringFunc". In practice, those string functions are part of the global namespace "::" However, we don't want to gather all functions in the global namespace under one page, since they have different contexts, different functionality and different documentation, and also the link to the header files are different. Here is a list of functions/structs/macros in the global namespace: DM_ALIGN, dmArray, dmHash, dmStr, dmLog*

JCash commented 4 years ago

In short, I cannot set "namespace" to an empty value.