dub icon indicating copy to clipboard operation
dub copied to clipboard

add docs command

Open MartinNowak opened this issue 10 years ago • 6 comments
trafficstars

Should become the new subcommand for document generation, the current -b docs and -b ddox methods are hardly configurable. http://forum.dlang.org/thread/[email protected]#post-tcunkoqxnzcsjzfajjvn:40forum.dlang.org

MartinNowak avatar Feb 02 '15 18:02 MartinNowak

+1 The post is a bit old, the unittest-by default is long-fixed.

What should 'docs' be able to do ? One of the killer feature I'd like to see in is the ability to integrate directly with Github (see: #355 & #449 )

Geod24 avatar Feb 11 '15 13:02 Geod24

The lack of configurability is a real pain at the moment

John-Colvin avatar Aug 12 '15 08:08 John-Colvin

You should mention in the documentation that the existing -b docs is recursive "dumb". I was irritated (several hours long) when i only wanted to generate documentation for my own project.

Jedzia avatar Dec 06 '18 14:12 Jedzia

Desperate ping. I need to build docs for my project only, not dependencies.

pbbob avatar May 14 '19 21:05 pbbob

You could add this issue to the DUB User experience story here (https://github.com/dlang/projects/issues/1) and I recommend voting for it (via GitHub reactions).

wilzbach avatar May 14 '19 21:05 wilzbach

My current workaround for this:

  1. build using dub -b ddox to get the docs.json file properly generated.
  2. ~~remove docs directory~~ Can't do this actually, because dub build -b ddox copies some css and other stuff that the main ddox command does not (rsync the public stuff)
  3. run ddox directly with command line I want.

It would be great to be able to configure the doc generation.

schveiguy avatar Sep 18 '21 15:09 schveiguy