Re: Workbench fails to build documentation
- To: mathgroup at smc.vnet.net
- Subject: [mg110501] Re: Workbench fails to build documentation
- From: telefunkenvf14 <rgorka at gmail.com>
- Date: Mon, 21 Jun 2010 02:12:16 -0400 (EDT)
- References: <hviamr$h3m$1@smc.vnet.net>
On Jun 19, 6:46 am, "M.Roellig" <markus.roel... at googlemail.com> wrote: > Hi group, > > after some frustrating fights with Workbench 2 and quite unconclusive > emails with Wolfram Support I would like to ask if anybody else is > having similar problems or even any ideas how to solve them. > > The problem is: Workbench completely fails to build any documemntation > file. No matter which. I tried to use the example projects from the > Wolfram web pages. I used simple test cases. I even tried an fresh and > empty project > with an empty template page for a guides page. Everything else works > fine as far as I can tell. I can call the Mathematica kernel from > Workbench, I can debug code. I can run notebooks from within Workbench > as Mathematica and so on. It's just the building of documentation that > fails. I even reinistalled Workbench AND Mathematica. Wolfram support > has no clue what the problem might be and basically gave up which I > find somewhat unsupportive... > I created a test user to make sure that no umlauts in the user name/ > path are messing things up. > > The building attempts produce the following messages in the cosole > window: > > -------------- > BEGIN----------------------------------------------------- > > Buildfile: C:\Users\Test\WolframWorkspaces\Base\PathTest\docbuild.xml > clean: > main: > docbuild: > [echo] DocumentationBuild: C:\Users\Test\.eclipse > \1678130227\configuration\org.eclipse.osgi\bundles\10\1\.cp > \MathematicaSource > [echo] Mathematica Install Dir: C:\Program Files\Wolfram Resea= rch > \Mathematica\7.0 > [echo] MathKernel: C:\Program Files\Wolfram Research\Mathemati= ca > \7.0\MathKernel.exe > [echo] Input: C:\Users\Test\WolframWorkspaces\Base\PathTest/ > PathTest/Documentation > [echo] Output NB: C:\Users\Test\WolframWorkspaces\Base\PathTes= t/ > build/PathTest/Documentation > [echo] Output Web: C:\Users\Test\WolframWorkspaces\Base\PathTe= st/ > build/PathTest-HTML > initMathematicaTask: > main: > [echo] DOCUMENTATION BUILD > [echo] Source: C:\Users\Test\WolframWorkspaces\Base\PathTest/ > PathTest/Documentation > [echo] Destination: C:\Users\Test\WolframWorkspaces\Base\PathT= est/ > build/PathTest/Documentation > [echo] Language: English > [echo] Log path: C:\Users\Test\WolframWorkspaces\Base\PathTest= / > build/log/log.txt > [echo] Exitcode path: C:\Users\Test\WolframWorkspaces\Base > \PathTest/build/log/exitcode.txt > [echo] Application path: C:\Users\Test\.eclipse > \1678130227\configuration\org.eclipse.osgi\bundles\10\1\.cp > \MathematicaSource > [echo] JLink path: C:\Program Files\Wolfram Research\Mathemati= ca > \7.0/SystemFiles/Links/JLink > [echo] Build Index: True > [echo] Link base: PathTest > [echo] Script: C:\Users\Test\.eclipse\1678130227\configuration > \org.eclipse.osgi\bundles\10\1\.cp\MathematicaSource\DocumentationBuild > \SystemFiles\ant\Build\notebook.xml > > BUILD FAILED > C:\Users\Test\WolframWorkspaces\Base\PathTest\docbuild.xml:132: The > following error occurred while executing this line: > C:\Users\Test\WolframWorkspaces\Base\PathTest\docbuild.xml:97: The > following error occurred while executing this line: > C:\Users\Test\.eclipse\1678130227\configuration\org.eclipse.osgi > \bundles\10\1\.cp\MathematicaSource\DocumentationBuild\SystemFiles\ant > \Build\notebook.xml:71: Failed to launch or connect to Mathematica > kernel: Connected MathLink program has closed the link, but there > might still be data underway. > > Total time: 764 milliseconds > > --------------------------END --------------------------------- > > I am using Windows 7 Enterprise 64 Bit. > > $Version > > "7.0 for Microsoft Windows (64-bit) (February 18, 2009)" > > Any ideas? > > Cheers, > > Markus If I had to guess... In Workbench, double-click on the PackletInfo.m file and then on the 'Documentation' tab (at the bottom of the screen). Now, highlight 'Guide' and create a new page (say, 'MyGuide'), and then highlight 'Tutorial' and create another new page (say, 'MyTutorial'. You don't actually have to fill these out yet. Select the 'MyGuide' page you've just created and hit the 'Set Main' button. Assuming you already have a bunch of functions with basic usage mesages defined in your package, when you expand the 'Symbols' folder, you should see a list of these functions. If they have a red X in front of them, then the function pages have not yet been created. One way to create a function page is to double click on one of these and follow the prompt. Mathematica will then open, and a new template will be generated for the function. You can then save and close it (or edit it, of course). Alternatively, you can create a bunch of these templates at once. To do so, click the 'Create Symbol Pages' button and choose the 'Select Missing' button. Mathematica will then iteratively build them all. Pretty slick, IMO. Make sure you're PackletInfo.m is saved and the build process *should* work now. :) Hope this helps... (I'm not a Workbench expert by any means) -RG