From: M.Roellig on
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 Research
\Mathematica\7.0
[echo] MathKernel: C:\Program Files\Wolfram Research\Mathematica
\7.0\MathKernel.exe
[echo] Input: C:\Users\Test\WolframWorkspaces\Base\PathTest/
PathTest/Documentation
[echo] Output NB: C:\Users\Test\WolframWorkspaces\Base\PathTest/
build/PathTest/Documentation
[echo] Output Web: C:\Users\Test\WolframWorkspaces\Base\PathTest/
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\PathTest/
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\Mathematica
\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

From: telefunkenvf14 on
On Jun 19, 6:46 am, "M.Roellig" <markus.roel...(a)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

From: Patrick Scheibe on
Hi,

for building the doc Mathematica starts a new kernel. If you have
already 2 running kernels this fails and this here

> \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

looks really like it happens to you.
So try to close one Mathematica and it should work again.

Cheers
Patrick


> 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
>


From: M.Roellig on
Thanks a lot for the answers.


I am aware that Workbench needs to start a kernel. I am not
running any. For some reason Workbench can start a kernel if
I want to debug or run a notebook but fails to do so for building
the docu.




<On 21 Jun., 08:15, Patrick Scheibe <psche...(a)trm.uni-leipzig.de>
wrote:
> Hi,
>
> for building the doc Mathematica starts a new kernel. If you have
> already 2 running kernels this fails and this here
>
> > \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
>
> looks really like it happens to you.
> So try to close one Mathematica and it should work again.
>
> Cheers
> Patrick
>
>
>
> > 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- Zitierten Text ausblenden -
>
> - Zitierten Text anzeigen -


From: Gerry Flanagan on
I saw the line
> build/PathTest-HTML
>
go by. I had problems with the "Create HTML" checkbox under Application
Tools. I never researched further because unclicking the box gave me
what I wanted.
Gerry F.


On 6/21/2010 2:12 AM, telefunkenvf14 wrote:
> On Jun 19, 6:46 am, "M.Roellig"<markus.roel...(a)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 Research
>
>> \Mathematica\7.0
>> [echo] MathKernel: C:\Program Files\Wolfram Research\Mathematica
>
>> \7.0\MathKernel.exe
>> [echo] Input: C:\Users\Test\WolframWorkspaces\Base\PathTest/
>> PathTest/Documentation
>> [echo] Output NB: C:\Users\Test\WolframWorkspaces\Base\PathTest/
>
>> build/PathTest/Documentation
>> [echo] Output Web: C:\Users\Test\WolframWorkspaces\Base\PathTest/
>
>> 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\PathTest/
>
>> 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\Mathematica
>
>> \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
>
>
>