How to compile Fenics/Dolfin help?

Asked by Sergey Alyaev

I cannot find detailed instructions of how to compile help for Fenics.
I am installing Fenics using Dorsal.

Previously I have got instructions from Marie to run "make doc" from build folder. But I have not find that folder in my installation.

Question information

Language:
English Edit question
Status:
Answered
For:
DOLFIN Edit question
Assignee:
No assignee Edit question
Last query:
Last reply:
Revision history for this message
Marie Rognes (meg-simula) said :
#1

On 07/04/11 16:50, Sergey Alyaev wrote:
> New question #163724 on DOLFIN:
> https://answers.launchpad.net/dolfin/+question/163724
>
> I cannot find detailed instructions of how to compile help for Fenics.
> I am installing Fenics using Dorsal.
>
> Previously I have got instructions from Marie to run "make doc" from build folder. But I have not find that folder in my installation.
>

As far as I remember, dorsal generates a dorsal_build_dir as a
subdirectory for each of the FEniCS components.

If you have installed the development versions, try

     cd dolfin/dorsal_build_dir
     make doc_install

The generated html-documentation will be in

     the_specified_install_folder/share/dolfin/doc/sphinx-cpp/build/html/
     the_specified_install_folder/share/dolfin/doc/sphinx-python/build/html/

for the C++ and the Python interfaces respectively

--
Marie

Revision history for this message
Sergey Alyaev (cobxo3bot) said :
#2

I am using developer version and I have
found directory /src/dolfin/dorsal_build_dir containing a makefile.
However the command "make doc_install" results in
make: *** No rule to make target `doc_install'. Stop.
I have checked out my makefile and that is the list of supported objects it
contains in the end, which does not seem to have anything dealing with help:

help:
@echo "The following are some of the valid targets for this Makefile:"
@echo "... all (the default if no target is provided)"
@echo "... clean"
@echo "... depend"
@echo "... demo"
@echo "... edit_cache"
@echo "... install"
@echo "... install/local"
@echo "... install/strip"
@echo "... install_dolfin_utils"
@echo "... list_install_components"
@echo "... rebuild_cache"
@echo "... test"
@echo "... uninstall"
@echo "... dolfin"
@echo "... _cpp"
@echo "... demo_eigenvalue"
.................................some more demo_ in between
@echo "... demo_waveguide"
@echo "... test_fem"
.................................some more test_ in between
@echo "... test_quadrature"
Sergey

On Mon, Jul 4, 2011 at 5:55 PM, Marie Rognes <
<email address hidden>> wrote:

> Your question #163724 on DOLFIN changed:
> https://answers.launchpad.net/dolfin/+question/163724
>
> Status: Open => Answered
>
> Marie Rognes proposed the following answer:
> On 07/04/11 16:50, Sergey Alyaev wrote:
> > New question #163724 on DOLFIN:
> > https://answers.launchpad.net/dolfin/+question/163724
> >
> > I cannot find detailed instructions of how to compile help for Fenics.
> > I am installing Fenics using Dorsal.
> >
> > Previously I have got instructions from Marie to run "make doc" from
> build folder. But I have not find that folder in my installation.
> >
>
> As far as I remember, dorsal generates a dorsal_build_dir as a
> subdirectory for each of the FEniCS components.
>
> If you have installed the development versions, try
>
> cd dolfin/dorsal_build_dir
> make doc_install
>
> The generated html-documentation will be in
>
> the_specified_install_folder/share/dolfin/doc/sphinx-cpp/build/html/
> the_specified_install_folder/share/dolfin/doc/sphinx-python/build/html/
>
> for the C++ and the Python interfaces respectively
>
> --
> Marie
>
> --
> If this answers your question, please go to the following page to let us
> know that it is solved:
> https://answers.launchpad.net/dolfin/+question/163724/+confirm?answer_id=0
>
> If you still need help, you can reply to this email or go to the
> following page to enter your feedback:
> https://answers.launchpad.net/dolfin/+question/163724
>
> You received this question notification because you asked the question.
>

Revision history for this message
Marie Rognes (meg-simula) said :
#3

Hm, do you have Sphinx installed? (preferably v1.0.7 or greater)

--
Marie

On 4. juli 2011, at 19:25, Sergey Alyaev <email address hidden> wrote:

> Question #163724 on DOLFIN changed:
> https://answers.launchpad.net/dolfin/+question/163724
>
> Status: Answered => Open
>
> Sergey Alyaev is still having a problem:
> I am using developer version and I have
> found directory /src/dolfin/dorsal_build_dir containing a makefile.
> However the command "make doc_install" results in
> make: *** No rule to make target `doc_install'. Stop.
> I have checked out my makefile and that is the list of supported objects it
> contains in the end, which does not seem to have anything dealing with help:
>
> help:
> @echo "The following are some of the valid targets for this Makefile:"
> @echo "... all (the default if no target is provided)"
> @echo "... clean"
> @echo "... depend"
> @echo "... demo"
> @echo "... edit_cache"
> @echo "... install"
> @echo "... install/local"
> @echo "... install/strip"
> @echo "... install_dolfin_utils"
> @echo "... list_install_components"
> @echo "... rebuild_cache"
> @echo "... test"
> @echo "... uninstall"
> @echo "... dolfin"
> @echo "... _cpp"
> @echo "... demo_eigenvalue"
> .................................some more demo_ in between
> @echo "... demo_waveguide"
> @echo "... test_fem"
> .................................some more test_ in between
> @echo "... test_quadrature"
> Sergey
>
>
> On Mon, Jul 4, 2011 at 5:55 PM, Marie Rognes <
> <email address hidden>> wrote:
>
>> Your question #163724 on DOLFIN changed:
>> https://answers.launchpad.net/dolfin/+question/163724
>>
>> Status: Open => Answered
>>
>> Marie Rognes proposed the following answer:
>> On 07/04/11 16:50, Sergey Alyaev wrote:
>>> New question #163724 on DOLFIN:
>>> https://answers.launchpad.net/dolfin/+question/163724
>>>
>>> I cannot find detailed instructions of how to compile help for Fenics.
>>> I am installing Fenics using Dorsal.
>>>
>>> Previously I have got instructions from Marie to run "make doc" from
>> build folder. But I have not find that folder in my installation.
>>>
>>
>> As far as I remember, dorsal generates a dorsal_build_dir as a
>> subdirectory for each of the FEniCS components.
>>
>> If you have installed the development versions, try
>>
>> cd dolfin/dorsal_build_dir
>> make doc_install
>>
>> The generated html-documentation will be in
>>
>> the_specified_install_folder/share/dolfin/doc/sphinx-cpp/build/html/
>> the_specified_install_folder/share/dolfin/doc/sphinx-python/build/html/
>>
>> for the C++ and the Python interfaces respectively
>>
>> --
>> Marie
>>
>> --
>> If this answers your question, please go to the following page to let us
>> know that it is solved:
>> https://answers.launchpad.net/dolfin/+question/163724/+confirm?answer_id=0
>>
>> If you still need help, you can reply to this email or go to the
>> following page to enter your feedback:
>> https://answers.launchpad.net/dolfin/+question/163724
>>
>> You received this question notification because you asked the question.
>>
>
> --
> You received this question notification because you are a member of
> DOLFIN Team, which is an answer contact for DOLFIN.

Revision history for this message
Sergey Alyaev (cobxo3bot) said :
#4

No,
I am not quite sure what it is, but probably you mean python-sphinx.
I have installed the current vertion from ubuntu repository which happens to
be 0.6.4-1.
What should I try next? Should I reinstall Fenics?

Sergey

On Mon, Jul 4, 2011 at 8:01 PM, Marie Rognes <
<email address hidden>> wrote:

> Your question #163724 on DOLFIN changed:
> https://answers.launchpad.net/dolfin/+question/163724
>
> Status: Open => Answered
>
> Marie Rognes proposed the following answer:
> Hm, do you have Sphinx installed? (preferably v1.0.7 or greater)
>
> --
> Marie
>
> On 4. juli 2011, at 19:25, Sergey Alyaev
> <email address hidden> wrote:
>
> > Question #163724 on DOLFIN changed:
> > https://answers.launchpad.net/dolfin/+question/163724
> >
> > Status: Answered => Open
> >
> > Sergey Alyaev is still having a problem:
> > I am using developer version and I have
> > found directory /src/dolfin/dorsal_build_dir containing a makefile.
> > However the command "make doc_install" results in
> > make: *** No rule to make target `doc_install'. Stop.
> > I have checked out my makefile and that is the list of supported objects
> it
> > contains in the end, which does not seem to have anything dealing with
> help:
> >
> > help:
> > @echo "The following are some of the valid targets for this Makefile:"
> > @echo "... all (the default if no target is provided)"
> > @echo "... clean"
> > @echo "... depend"
> > @echo "... demo"
> > @echo "... edit_cache"
> > @echo "... install"
> > @echo "... install/local"
> > @echo "... install/strip"
> > @echo "... install_dolfin_utils"
> > @echo "... list_install_components"
> > @echo "... rebuild_cache"
> > @echo "... test"
> > @echo "... uninstall"
> > @echo "... dolfin"
> > @echo "... _cpp"
> > @echo "... demo_eigenvalue"
> > .................................some more demo_ in between
> > @echo "... demo_waveguide"
> > @echo "... test_fem"
> > .................................some more test_ in between
> > @echo "... test_quadrature"
> > Sergey
> >
> >
> > On Mon, Jul 4, 2011 at 5:55 PM, Marie Rognes <
> > <email address hidden>> wrote:
> >
> >> Your question #163724 on DOLFIN changed:
> >> https://answers.launchpad.net/dolfin/+question/163724
> >>
> >> Status: Open => Answered
> >>
> >> Marie Rognes proposed the following answer:
> >> On 07/04/11 16:50, Sergey Alyaev wrote:
> >>> New question #163724 on DOLFIN:
> >>> https://answers.launchpad.net/dolfin/+question/163724
> >>>
> >>> I cannot find detailed instructions of how to compile help for Fenics.
> >>> I am installing Fenics using Dorsal.
> >>>
> >>> Previously I have got instructions from Marie to run "make doc" from
> >> build folder. But I have not find that folder in my installation.
> >>>
> >>
> >> As far as I remember, dorsal generates a dorsal_build_dir as a
> >> subdirectory for each of the FEniCS components.
> >>
> >> If you have installed the development versions, try
> >>
> >> cd dolfin/dorsal_build_dir
> >> make doc_install
> >>
> >> The generated html-documentation will be in
> >>
> >> the_specified_install_folder/share/dolfin/doc/sphinx-cpp/build/html/
> >>
> the_specified_install_folder/share/dolfin/doc/sphinx-python/build/html/
> >>
> >> for the C++ and the Python interfaces respectively
> >>
> >> --
> >> Marie
> >>
> >> --
> >> If this answers your question, please go to the following page to let us
> >> know that it is solved:
> >>
> https://answers.launchpad.net/dolfin/+question/163724/+confirm?answer_id=0
> >>
> >> If you still need help, you can reply to this email or go to the
> >> following page to enter your feedback:
> >> https://answers.launchpad.net/dolfin/+question/163724
> >>
> >> You received this question notification because you asked the question.
> >>
> >
> > --
> > You received this question notification because you are a member of
> > DOLFIN Team, which is an answer contact for DOLFIN.
>
> --
> If this answers your question, please go to the following page to let us
> know that it is solved:
> https://answers.launchpad.net/dolfin/+question/163724/+confirm?answer_id=2
>
> If you still need help, you can reply to this email or go to the
> following page to enter your feedback:
> https://answers.launchpad.net/dolfin/+question/163724
>
> You received this question notification because you asked the question.
>

Revision history for this message
Marie Rognes (meg-simula) said :
#5

On 07/04/11 20:21, Sergey Alyaev wrote:
> Question #163724 on DOLFIN changed:
> https://answers.launchpad.net/dolfin/+question/163724
>
> Status: Answered => Open
>
> Sergey Alyaev is still having a problem:
> No,
> I am not quite sure what it is, but probably you mean python-sphinx.

Yes: http://sphinx.pocoo.org/

> I have installed the current vertion from ubuntu repository which happens to
> be 0.6.4-1.
> What should I try next? Should I reinstall Fenics?
>

At least reconfigure and rebuild DOLFIN.

--
Marie

> Sergey
>
>
> On Mon, Jul 4, 2011 at 8:01 PM, Marie Rognes<
> <email address hidden>> wrote:
>
>> Your question #163724 on DOLFIN changed:
>> https://answers.launchpad.net/dolfin/+question/163724
>>
>> Status: Open => Answered
>>
>> Marie Rognes proposed the following answer:
>> Hm, do you have Sphinx installed? (preferably v1.0.7 or greater)
>>
>> --
>> Marie
>>
>> On 4. juli 2011, at 19:25, Sergey Alyaev
>> <email address hidden> wrote:
>>
>>> Question #163724 on DOLFIN changed:
>>> https://answers.launchpad.net/dolfin/+question/163724
>>>
>>> Status: Answered => Open
>>>
>>> Sergey Alyaev is still having a problem:
>>> I am using developer version and I have
>>> found directory /src/dolfin/dorsal_build_dir containing a makefile.
>>> However the command "make doc_install" results in
>>> make: *** No rule to make target `doc_install'. Stop.
>>> I have checked out my makefile and that is the list of supported objects
>> it
>>> contains in the end, which does not seem to have anything dealing with
>> help:
>>> help:
>>> @echo "The following are some of the valid targets for this Makefile:"
>>> @echo "... all (the default if no target is provided)"
>>> @echo "... clean"
>>> @echo "... depend"
>>> @echo "... demo"
>>> @echo "... edit_cache"
>>> @echo "... install"
>>> @echo "... install/local"
>>> @echo "... install/strip"
>>> @echo "... install_dolfin_utils"
>>> @echo "... list_install_components"
>>> @echo "... rebuild_cache"
>>> @echo "... test"
>>> @echo "... uninstall"
>>> @echo "... dolfin"
>>> @echo "... _cpp"
>>> @echo "... demo_eigenvalue"
>>> .................................some more demo_ in between
>>> @echo "... demo_waveguide"
>>> @echo "... test_fem"
>>> .................................some more test_ in between
>>> @echo "... test_quadrature"
>>> Sergey
>>>
>>>
>>> On Mon, Jul 4, 2011 at 5:55 PM, Marie Rognes<
>>> <email address hidden>> wrote:
>>>
>>>> Your question #163724 on DOLFIN changed:
>>>> https://answers.launchpad.net/dolfin/+question/163724
>>>>
>>>> Status: Open => Answered
>>>>
>>>> Marie Rognes proposed the following answer:
>>>> On 07/04/11 16:50, Sergey Alyaev wrote:
>>>>> New question #163724 on DOLFIN:
>>>>> https://answers.launchpad.net/dolfin/+question/163724
>>>>>
>>>>> I cannot find detailed instructions of how to compile help for Fenics.
>>>>> I am installing Fenics using Dorsal.
>>>>>
>>>>> Previously I have got instructions from Marie to run "make doc" from
>>>> build folder. But I have not find that folder in my installation.
>>>> As far as I remember, dorsal generates a dorsal_build_dir as a
>>>> subdirectory for each of the FEniCS components.
>>>>
>>>> If you have installed the development versions, try
>>>>
>>>> cd dolfin/dorsal_build_dir
>>>> make doc_install
>>>>
>>>> The generated html-documentation will be in
>>>>
>>>> the_specified_install_folder/share/dolfin/doc/sphinx-cpp/build/html/
>>>>
>> the_specified_install_folder/share/dolfin/doc/sphinx-python/build/html/
>>>> for the C++ and the Python interfaces respectively
>>>>
>>>> --
>>>> Marie
>>>>
>>>> --
>>>> If this answers your question, please go to the following page to let us
>>>> know that it is solved:
>>>>
>> https://answers.launchpad.net/dolfin/+question/163724/+confirm?answer_id=0
>>>> If you still need help, you can reply to this email or go to the
>>>> following page to enter your feedback:
>>>> https://answers.launchpad.net/dolfin/+question/163724
>>>>
>>>> You received this question notification because you asked the question.
>>>>
>>> --
>>> You received this question notification because you are a member of
>>> DOLFIN Team, which is an answer contact for DOLFIN.
>> --
>> If this answers your question, please go to the following page to let us
>> know that it is solved:
>> https://answers.launchpad.net/dolfin/+question/163724/+confirm?answer_id=2
>>
>> If you still need help, you can reply to this email or go to the
>> following page to enter your feedback:
>> https://answers.launchpad.net/dolfin/+question/163724
>>
>> You received this question notification because you asked the question.
>>

Revision history for this message
Martin Sandve Alnæs (martinal) said :
#6

On 5 July 2011 11:35, Marie Rognes <email address hidden> wrote:
> Question #163724 on DOLFIN changed:
> https://answers.launchpad.net/dolfin/+question/163724
>
>    Status: Open => Answered
>
> Marie Rognes proposed the following answer:
> On 07/04/11 20:21, Sergey Alyaev wrote:
>> Question #163724 on DOLFIN changed:
>> https://answers.launchpad.net/dolfin/+question/163724
>>
>>      Status: Answered =>  Open
>>
>> Sergey Alyaev is still having a problem:
>> No,
>> I am not quite sure what it is, but probably you mean python-sphinx.
>
> Yes: http://sphinx.pocoo.org/
>
>> I have installed the current vertion from ubuntu repository which happens to
>> be 0.6.4-1.
>> What should I try next? Should I reinstall Fenics?
>>
>
> At least reconfigure and rebuild DOLFIN.

Turns out the ubuntu natty version of sphinx is ancient,
so try 'easy_install -U Sphinx' if you still have problems.

Martin

Revision history for this message
Sergey Alyaev (cobxo3bot) said :
#7

Thank you for help.
Your solution worked in the end.

Though I needed to install boost_iostreams before it compiled.
Probably it would be nice to include these requirements into
Dorsal's suggested actions.

Sergey

On Tue, Jul 5, 2011 at 11:51 AM, Martin Sandve Alnæs <
<email address hidden>> wrote:

> Your question #163724 on DOLFIN changed:
> https://answers.launchpad.net/dolfin/+question/163724
>
> Martin Sandve Alnæs proposed the following answer:
> On 5 July 2011 11:35, Marie Rognes <email address hidden>
> wrote:
> > Question #163724 on DOLFIN changed:
> > https://answers.launchpad.net/dolfin/+question/163724
> >
> > Status: Open => Answered
> >
> > Marie Rognes proposed the following answer:
> > On 07/04/11 20:21, Sergey Alyaev wrote:
> >> Question #163724 on DOLFIN changed:
> >> https://answers.launchpad.net/dolfin/+question/163724
> >>
> >> Status: Answered => Open
> >>
> >> Sergey Alyaev is still having a problem:
> >> No,
> >> I am not quite sure what it is, but probably you mean python-sphinx.
> >
> > Yes: http://sphinx.pocoo.org/
> >
> >> I have installed the current vertion from ubuntu repository which
> happens to
> >> be 0.6.4-1.
> >> What should I try next? Should I reinstall Fenics?
> >>
> >
> > At least reconfigure and rebuild DOLFIN.
>
> Turns out the ubuntu natty version of sphinx is ancient,
> so try 'easy_install -U Sphinx' if you still have problems.
>
> Martin
>
> --
> If this answers your question, please go to the following page to let us
> know that it is solved:
> https://answers.launchpad.net/dolfin/+question/163724/+confirm?answer_id=5
>
> If you still need help, you can reply to this email or go to the
> following page to enter your feedback:
> https://answers.launchpad.net/dolfin/+question/163724
>
> You received this question notification because you asked the question.
>

Revision history for this message
Launchpad Janitor (janitor) said :
#8

This question was expired because it remained in the 'Open' state without activity for the last 15 days.

Revision history for this message
Garth Wells (garth-wells) said :
#9

-

Can you help with this problem?

Provide an answer of your own, or ask Sergey Alyaev for more information if necessary.

To post a message you must log in.