www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.learn - Docs for subpackages?

reply 9il <ilyayaroshenko gmail.com> writes:
Hi,

I am trying to build a large project that is split into dozen of 
sub-packages.
How I can do it using dub without writing my own doc scripts?
--combined does not help here.

Best regards,
Ilya
Jun 13 2018
parent reply 9il <ilyayaroshenko gmail.com> writes:
On Wednesday, 13 June 2018 at 14:56:10 UTC, 9il wrote:

 Hi,

 I am trying to build a large project that is split into dozen 
 of sub-packages.
 How I can do it using dub without writing my own doc scripts?
 --combined does not help here.

 Best regards,
 Ilya


UPDATE: --combined works, but DDOX fails

std.json.JSONException std/json.d(1394): Got JSON of type 
undefined, expected string.
----------------
4   ddox                                0x0000000107c667fa const 
pure  safe void 
vibe.data.json.Json.checkType!(immutable(char)[]).checkType(immutable(char)[])
+ 278
5   ddox                                0x0000000107c666cb inout 
 property  trusted inout(immutable(char)[]) 
vibe.data.json.Json.get!(immutable(char)[]).get() + 31
6   ddox                                0x0000000107dba2bc 
ddox.entities.Declaration 
ddox.parsers.jsonparser.Parser.parseDecl(vibe.data.json.Json, 
ddox.entities.Entity) + 72
7   ddox                                0x0000000107dba106 int 
ddox.parsers.jsonparser.Parser.parseDeclList(vibe.data.json.Json, 
ddox.entities.Entity).__foreachbody3(ref vibe.data.json.Json) + 90
8   ddox                                0x0000000107fe1fd7 int 
vibe.data.json.Json.opApply(scope int delegate(ref 
vibe.data.json.Json)) + 159
9   ddox                                0x0000000107dba09a 
ddox.entities.Declaration[] 
ddox.parsers.jsonparser.Parser.parseDeclList(vibe.data.json.Json, 
ddox.entities.Entity) + 78
10  ddox                                0x0000000107dbb024 
ddox.entities.CompositeTypeDeclaration 
ddox.parsers.jsonparser.Parser.parseCompositeDecl(vibe.data.json.Json,
ddox.entities.Entity) + 712
11  ddox                                0x0000000107dba520 
ddox.entities.Declaration 
ddox.parsers.jsonparser.Parser.parseDecl(vibe.data.json.Json, 
ddox.entities.Entity) + 684
12  ddox                                0x0000000107dba106 int 
ddox.parsers.jsonparser.Parser.parseDeclList(vibe.data.json.Json, 
ddox.entities.Entity).__foreachbody3(ref vibe.data.json.Json) + 90
13  ddox                                0x0000000107fe1fd7 int 
vibe.data.json.Json.opApply(scope int delegate(ref 
vibe.data.json.Json)) + 159
14  ddox                                0x0000000107dba09a 
ddox.entities.Declaration[] 
ddox.parsers.jsonparser.Parser.parseDeclList(vibe.data.json.Json, 
ddox.entities.Entity) + 78
15  ddox                                0x0000000107db8ef3 void 
ddox.parsers.jsonparser.Parser.parseModuleDecls(vibe.data.json.Json,
ddox.entities.Package) + 583
16  ddox                                0x0000000107db8c9f int 
ddox.parsers.jsonparser.parseJsonDocs(vibe.data.json.Json, 
ddox.entities.Package).__foreachbody3(ref vibe.data.json.Json) + 
91
17  ddox                                0x0000000107fe1fd7 int 
vibe.data.json.Json.opApply(scope int delegate(ref 
vibe.data.json.Json)) + 159
18  ddox                                0x0000000107db8c2d 
ddox.entities.Package 
ddox.parsers.jsonparser.parseJsonDocs(vibe.data.json.Json, 
ddox.entities.Package) + 89
19  ddox                                0x0000000107d9d53c 
ddox.entities.Package ddox.main.parseDocFile(immutable(char)[], 
ddox.settings.DdoxSettings) + 168
20  ddox                                0x0000000107d9c1ad int 
ddox.main.setupGeneratorInput(ref immutable(char)[][], out 
ddox.settings.GeneratorSettings, out ddox.entities.Package) + 777
21  ddox                                0x0000000107d9bab6 int 
ddox.main.cmdGenerateHtml(immutable(char)[][]) + 42
22  ddox                                0x0000000107d9b945 int 
ddox.main.ddoxMain(immutable(char)[][]) + 201
23  ddox                                0x0000000107c617bf _Dmain 
+ 31
24  ddox                                0x000000010800d037 void 
rt.dmain2._d_run_main(int, char**, extern (C) int 
function(char[][])*).runAll().__lambda1() + 39
25  ddox                                0x000000010800cec7 void 
rt.dmain2._d_run_main(int, char**, extern (C) int 
function(char[][])*).tryExec(scope void delegate()) + 31
26  ddox                                0x000000010800cfa2 void 
rt.dmain2._d_run_main(int, char**, extern (C) int 
function(char[][])*).runAll() + 138
27  ddox                                0x000000010800cec7 void 
rt.dmain2._d_run_main(int, char**, extern (C) int 
function(char[][])*).tryExec(scope void delegate()) + 31
28  ddox                                0x000000010800ce35 
_d_run_main + 485
29  ddox                                0x0000000107c617e9 main + 
33
30  libdyld.dylib                       0x00007fff7d479014 start 
+ 0
31  ???                                 0x0000000000000004 0x0 + 4
Jun 13 2018
parent Guillaume Piolat <first.last gmail.com> writes:
On Thursday, 14 June 2018 at 04:39:16 UTC, 9il wrote:

 On Wednesday, 13 June 2018 at 14:56:10 UTC, 9il wrote:

 Hi,

 I am trying to build a large project that is split into dozen 
 of sub-packages.
 How I can do it using dub without writing my own doc scripts?
 --combined does not help here.

 Best regards,
 Ilya




If your project is public you can use dpldocs.

http://mir.dpldocs.info/index.html
Jun 15 2018