[petsc-dev] building sphinx doc only

[Barry Smith]

  Takes 10 minutes on my Apple M2 laptop.

  As Satish notes, it has several stages, each of which takes some nontrivial time. Hence, it is unclear if any simple change to the process could reduce the time significantly, but I think 30 minutes in the CI is too long, and it would be nice if someone worked on decreasing the time it needs.



> On Jun 15, 2023, at 11:30 AM, Satish Balay via petsc-dev <petsc-dev at mcs.anl.gov> wrote:
> 
> On Thu, 15 Jun 2023, Blaise Bourdin wrote:
> 
>> Hi,
>> 
>> I am trying to figure out why the doc page for PetscOptionsHeadBegin https://petsc.org/release/manualpages/Sys/PetscOptionsHeadBegin/ is broken.
>> Following the instructions at https://petsc.org/release/developers/documentation/#developing-petsc-documentation 
>> I do 
>> 
>> cd $PETSC_DIR/doc
>> make sphinxhtml
>> 
>> which takes ages and seems to also build the old style html documentation. Is this right?
> 
> doc build is a complex multi step process - and takes about 30+min in CI
> 
> https://gitlab.com/petsc/petsc/-/jobs/4475363877
> 
> Satish
> 
>> 
>> Regards,
>> Blaise
>> 
>> — 
>> Canada Research Chair in Mathematical and Computational Aspects of Solid Mechanics (Tier 1)
>> Professor, Department of Mathematics & Statistics
>> Hamilton Hall room 409A, McMaster University
>> 1280 Main Street West, Hamilton, Ontario L8S 4K1, Canada 
>> https://www.math.mcmaster.ca/bourdin | +1 (905) 525 9140 ext. 27243
>> 
>>