plplot-devel

[Plplot-devel] Documentation bug

[Phil R. <p.d...@gm...>]

Hi
I have added some documentation to plGraphicsIn and moved the
documentation I wrote recently for plTranslateCursor to the C API.
However now I am getting the following error on Cygwin when I try to
build the pdf

Build plplotdoc-print.pdf

Unexpected error occured

Error: [Errno 16] Device or resource busy:
'/cygdrive/d/usr/local/src/plplot-plplot/build/cygwin/doc/docbook/src/plplot-5.11.1.pdf'

doc/docbook/src/CMakeFiles/pdf_target.dir/build.make:87: recipe for
target 'doc/docbook/src/plplot-5.11.1.pdf' failed

make[3]: *** [doc/docbook/src/plplot-5.11.1.pdf] Error 1

CMakeFiles/Makefile2:1802: recipe for target
'doc/docbook/src/CMakeFiles/pdf_target.dir/all' failed

make[2]: *** [doc/docbook/src/CMakeFiles/pdf_target.dir/all] Error 2

CMakeFiles/Makefile2:1601: recipe for target
'doc/docbook/src/CMakeFiles/build_docbook_documentation.dir/rule'
failed

make[1]: *** [doc/docbook/src/CMakeFiles/build_docbook_documentation.dir/rule]
Error 2

Makefile:457: recipe for target 'build_docbook_documentation' failed

make: *** [build_docbook_documentation] Error 2

I don't suppose anyone has seen this before or could try to reproduce
it on a proper Linux system to check it's not a Cygwin related issue?
I have attached a patch

Re: [Plplot-devel] Documentation bug

[Alan W. I. <ir...@be...>]

On 2015-12-22 22:40-0000 Phil Rosenberg wrote:

> Hi
> I have added some documentation to plGraphicsIn and moved the
> documentation I wrote recently for plTranslateCursor to the C API.
> However now I am getting the following error on Cygwin when I try to
> build the pdf
>
> Build plplotdoc-print.pdf
>
> Unexpected error occured
>
> Error: [Errno 16] Device or resource busy:
> '/cygdrive/d/usr/local/src/plplot-plplot/build/cygwin/doc/docbook/src/plplot-5.11.1.pdf'
>
> doc/docbook/src/CMakeFiles/pdf_target.dir/build.make:87: recipe for
> target 'doc/docbook/src/plplot-5.11.1.pdf' failed
>
> make[3]: *** [doc/docbook/src/plplot-5.11.1.pdf] Error 1
>
> CMakeFiles/Makefile2:1802: recipe for target
> 'doc/docbook/src/CMakeFiles/pdf_target.dir/all' failed
>
> make[2]: *** [doc/docbook/src/CMakeFiles/pdf_target.dir/all] Error 2
>
> CMakeFiles/Makefile2:1601: recipe for target
> 'doc/docbook/src/CMakeFiles/build_docbook_documentation.dir/rule'
> failed
>
> make[1]: *** [doc/docbook/src/CMakeFiles/build_docbook_documentation.dir/rule]
> Error 2
>
> Makefile:457: recipe for target 'build_docbook_documentation' failed
>
> make: *** [build_docbook_documentation] Error 2
>
> I don't suppose anyone has seen this before or could try to reproduce
> it on a proper Linux system to check it's not a Cygwin related issue?
> I have attached a patch

Hi Phil:

It turns out your patch was LF rather than CRLF (which
is obviously fine with me).  Is that because you produced it with
Cygwin git?

Anyhow, your patch applied without issues using "git am <patch file
name>".


One small workflow issue with your patch is these two lines

-          (<literal>PLINT</literal>, input)
+          (<literal>PLINT </literal>, input)

which restored that blank which I had just removed in one of my recent
"tweak" commits.  I don't really understand how this happened, but my
guess is you forgot to git rebase before you sent me the git
format-patch result.

Anyhow, I have used "git commit --amend" to restore my blank removal
tweak.

Finally, I tweaked the wording of your documentation change a bit
when I amended your commit.  The final version is given
in commit 9863b15.


I forgot to say in that commit message that there were no validation
errors and the results built (in parallel with "make -j4 all") without
issues on Debian jessie.

Please try building commit 9863b15

If you continue to get the above "resource busy" issue, is it possible
you are attempting a parallel build on Cygwin?  Previous experience by
Arjen and Greg indicate parallel builds are problematic on modern Cygwin
(although they used to work fine for older versions of Cygwin).

Alan
__________________________
Alan W. Irwin

Astronomical research affiliation with Department of Physics and Astronomy,
University of Victoria (astrowww.phys.uvic.ca).

Programming affiliations with the FreeEOS equation-of-state
implementation for stellar interiors (freeeos.sf.net); the Time
Ephemerides project (timeephem.sf.net); PLplot scientific plotting
software package (plplot.sf.net); the libLASi project
(unifont.org/lasi); the Loads of Linux Links project (loll.sf.net);
and the Linux Brochure Project (lbproject.sf.net).
__________________________

Linux-powered Science
__________________________

Re: [Plplot-devel] Documentation bug

[Phil R. <p.d...@gm...>]

Hi Alan
Thanks, the parallel build seems to have been the issue. I have added
a note to the documentation readme to warn that the recommended -j4
option does not work under Cygwin.

Phil

On 24 December 2015 at 22:40, Alan W. Irwin <ir...@be...> wrote:
> On 2015-12-22 22:40-0000 Phil Rosenberg wrote:
>
>> Hi
>> I have added some documentation to plGraphicsIn and moved the
>> documentation I wrote recently for plTranslateCursor to the C API.
>> However now I am getting the following error on Cygwin when I try to
>> build the pdf
>>
>> Build plplotdoc-print.pdf
>>
>> Unexpected error occured
>>
>> Error: [Errno 16] Device or resource busy:
>>
>> '/cygdrive/d/usr/local/src/plplot-plplot/build/cygwin/doc/docbook/src/plplot-5.11.1.pdf'
>>
>> doc/docbook/src/CMakeFiles/pdf_target.dir/build.make:87: recipe for
>> target 'doc/docbook/src/plplot-5.11.1.pdf' failed
>>
>> make[3]: *** [doc/docbook/src/plplot-5.11.1.pdf] Error 1
>>
>> CMakeFiles/Makefile2:1802: recipe for target
>> 'doc/docbook/src/CMakeFiles/pdf_target.dir/all' failed
>>
>> make[2]: *** [doc/docbook/src/CMakeFiles/pdf_target.dir/all] Error 2
>>
>> CMakeFiles/Makefile2:1601: recipe for target
>> 'doc/docbook/src/CMakeFiles/build_docbook_documentation.dir/rule'
>> failed
>>
>> make[1]: ***
>> [doc/docbook/src/CMakeFiles/build_docbook_documentation.dir/rule]
>> Error 2
>>
>> Makefile:457: recipe for target 'build_docbook_documentation' failed
>>
>> make: *** [build_docbook_documentation] Error 2
>>
>> I don't suppose anyone has seen this before or could try to reproduce
>> it on a proper Linux system to check it's not a Cygwin related issue?
>> I have attached a patch
>
>
> Hi Phil:
>
> It turns out your patch was LF rather than CRLF (which
> is obviously fine with me).  Is that because you produced it with
> Cygwin git?
>
> Anyhow, your patch applied without issues using "git am <patch file
> name>".
>
>
> One small workflow issue with your patch is these two lines
>
> -          (<literal>PLINT</literal>, input)
> +          (<literal>PLINT </literal>, input)
>
> which restored that blank which I had just removed in one of my recent
> "tweak" commits.  I don't really understand how this happened, but my
> guess is you forgot to git rebase before you sent me the git
> format-patch result.
>
> Anyhow, I have used "git commit --amend" to restore my blank removal
> tweak.
>
> Finally, I tweaked the wording of your documentation change a bit
> when I amended your commit.  The final version is given
> in commit 9863b15.
>
>
> I forgot to say in that commit message that there were no validation
> errors and the results built (in parallel with "make -j4 all") without
> issues on Debian jessie.
>
> Please try building commit 9863b15
>
> If you continue to get the above "resource busy" issue, is it possible
> you are attempting a parallel build on Cygwin?  Previous experience by
> Arjen and Greg indicate parallel builds are problematic on modern Cygwin
> (although they used to work fine for older versions of Cygwin).
>
>
> Alan
> __________________________
> Alan W. Irwin
>
> Astronomical research affiliation with Department of Physics and Astronomy,
> University of Victoria (astrowww.phys.uvic.ca).
>
> Programming affiliations with the FreeEOS equation-of-state
> implementation for stellar interiors (freeeos.sf.net); the Time
> Ephemerides project (timeephem.sf.net); PLplot scientific plotting
> software package (plplot.sf.net); the libLASi project
> (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net);
> and the Linux Brochure Project (lbproject.sf.net).
> __________________________
>
> Linux-powered Science
> __________________________

Re: [Plplot-devel] Documentation bug

[Alan W. I. <ir...@be...>]

On 2015-12-27 20:26-0000 Phil Rosenberg wrote:

> Hi Alan
> Thanks, the parallel build seems to have been the issue. I have added
> a note to the documentation readme to warn that the recommended -j4
> option does not work under Cygwin.

Hi Phil:

I am glad you discovered the source of the issue by following up on
that possibility I suggested.

The lack of reliable parallel build is an important issue on Cygwin
for those with access to multi-cpu PC's where substantial build
speedups will become available once parallel builds are reliable again
on Cygwin.

However, it is guaranteed that no Cygwin developer is going to do
anything about this important issue until someone brings a
reproducible problem to their attention. If the problem seems
reproducible in your case (i.e., -j4 always gives you a bad result
from a fresh start for 3 or more tries on your particular hardware),
then I suggest it is worth reporting the issue as a Cygwin bug report.

Assuming you are satisfied on the reproducibility question, and have
written such a bug report, it should be sent to the Cygwin mailing
list (the Cygwin developers prefer that way of reporting Cygwin bugs).
That report should contain a good description of your hardware
(especially the frequency and number of cpu(s) in case those hardware
attributes affect the reproducibility), and a cookbook (probably with
most wording lifted from doc/docbook/README.developers) of how our
documentation should be built on that platform.  Such details should
give the Cygwin developers a reasonable chance to reproduce the issue
consistently for themselves which is the first step in finding
and eventually fixing the bug.

Alan
__________________________
Alan W. Irwin

Astronomical research affiliation with Department of Physics and Astronomy,
University of Victoria (astrowww.phys.uvic.ca).

Programming affiliations with the FreeEOS equation-of-state
implementation for stellar interiors (freeeos.sf.net); the Time
Ephemerides project (timeephem.sf.net); PLplot scientific plotting
software package (plplot.sf.net); the libLASi project
(unifont.org/lasi); the Loads of Linux Links project (loll.sf.net);
and the Linux Brochure Project (lbproject.sf.net).
__________________________

Linux-powered Science
__________________________