> we just tried the experiment of naively moving the two directories > sdodasrel and sdo_das_xml inside the sdo directory and running make > html. That didn't work. I guess the build process won't automatically > look for reference.xml in subdirectories. > > We want to keep the structure we have where the documentation for the > two DASs look like the documentation for a regular extension (sections > for installation, functions, etc.) but have everything neatly in the sdo > directory. Do you know how we achieve this?
It is not possible (at least not intended at all) to have a structure under the extension reference folder other than the ones in place in existing extension documentation, ie. you should not move to extensions with their suggested folder structure under one folder as two subfolders. As far as I understand Jakub suggested to *merge* the contents of the folders, so that they appear as a single extension (given the assumption that despite the fact that they are conceptually two sets of functionality, they are in the same extension). If this assumption does not hold up, then there is no need to merge, otherwise we can discuss. Structuring of the extension list TOC is a different question, and we have a long time TODO item, partially completed to do the structure, without any modification in how the files are stored in the extension documentation. Goba
