MSBuild: Generate XML documentation for main project but not dependency projects -

-

i have .sln file several projects in it. keep simple, let's call them...

  • projecta
  • projectb
  • projectc

...where main project references b , c. goal update build script generate xml "intellisense" documentation file projecta, without giving build warnings missing documentation b , c.

current build script

i have msbuild script includes following in build step:

<propertygroup>     <customoutputpath>c:\build\output\</customoutputpath> </propertygroup> <itemgroup>     <projects include="projecta\projecta.csproj">         <properties>outputpath=$(customoutputpath)</properties>     </projects> </itemgroup> <msbuild projects="@(projects)" />

(there multiple projects listed in itemgroup, again, let's keep simple.)

when run build script, it's smart enough compile b, c, , me, though i've specified a. output appears in "customoutputpath" location.

the closest i've gotten...

if add 'documentationfile' property project entry...

<itemgroup>     <projects include="projecta\projecta.csproj">         <properties>outputpath=$(customoutputpath);documentationfile=projecta.xml</properties>     </projects> </itemgroup>

...then 'projecta.xml' appears in "customoutputpath". however, files named 'projecta.xml' in project folder 3 projects:

  • projecta/projecta.xml
  • projectb/projecta.xml
  • projectc/projecta.xml

these files contain "intellisense" documentation respective projects, though they're named "projecta.xml".

this creates undesired , misleadingly-named files in project folders, , (more importantly) generates build warnings missing documentation comments in b , c. don't want add documentation comments projects, i'd prefer find way have msbuild generate documentation projecta.

can provide insight, or alternative solution?

based on i've found - documentationfile global-level property (and used in creation of docfileitem - global level items list). understanding won't able alter in easy way in single logical script.

what can define special target in separate file imported every proj file (directly editing proj files or using properties $custombeforemicrosoftcommontargets) overwrite documentationfile project-dependent value. result - probably can generate different documentation file names different projects.

another solution - clean-up unnecessary doc files right after projs built.


Comments

Post a Comment

Popular posts from this blog

Detect support for Shoutcast ICY MP3 without navigator.userAgent in Firefox? -

-
the current version of mozilla firefox 23.0.1, version not support play mp3 shoutcast streams tcp port different 80 (most common 8000 shoutcast 1.9.8). i use flash when mp3 support not available in html5 audio, way detect is: try{ var = document.createelement('audio'); r = !!(a.canplaytype && !!a.canplaytype("audio/mpeg; codecs=mp3").replace(/^no$/,'')) }catch(e){ r = false; } the support mp3 shoutcast streams in firefox added in version 24 . a.canplaytype("audio/mpeg; codecs=mp3") = in chrome , firefox, chrome support, firefox not support, due current code detect not work firefox. the current version of jquery support ie 6 1.10.2, version not has .browser i think "stylized" way testing features , not querying browsers / versions, notwithstanding here see hard not violate "principle". what "stylized" way of detect mp3 icy support without navigator.useragent in firefox? ther...
Read more

web - SVG not rendering properly in Firefox -

-
i have problem svg renderring in firefox. whilst works in safari, chrome or in ie, doesn't work in firefox. inspecting element seems layers there, background visible if it's z-index higher z-index of others. rendered in firefox: svg logo in firefox link original source file: svg file thanks help. ps: used sketch 3 export svg. if helps somehow. you're experiencing bug 995813 . i fixed bug time ago change still making way through release process example display correctly firefox 31 onwards released on 22 july 2014. in meantime if move fill="white" <mask> element child <use> element work around firefox bug.
Read more

java - JavaFX 2 slider labelFormatter not being used -

-
i have following code not label slider "foo50", etc... 1 expect setlabelformatter call, instead seems have no effect (the slider labelled 50, 100, etc , println's dont run). there missing? not implemented in default 2.2 skin? using oracle java 7 package javafxbugtest; import javafx.application.application; import javafx.scene.*; import javafx.scene.control.*; import javafx.stage.*; import javafx.util.stringconverter; public class javafxbugtest extends application { @override public void start(final stage primarystage) { slider cp = new slider(); cp.setlabelformatter(new stringconverter<double>() { @override public string tostring(double t) { system.out.println("nope?"); return "foo" + t.tostring(); } @override public double fromstring(string string) { system.out.println("he...
Read more