On 2015-12-04, Kornel Benko wrote:
> Am 4. Dezember 2015 um 01:48:21, schrieb Uwe Stöhr <uwesto...@lyx.org>
>> commit 0311bda2b7c3a86a0ae7eb759b371d1e8fa2ad56
>> Author: Uwe Stöhr <uwesto...@lyx.org>
>> Date:   Fri Dec 4 01:48:14 2015 +0100

>>     Spanish Tutorial.lyx: preamble code proposed by Günther

>>     - please don't revert anything only because compiling with system
>>       fonts fails. This is not the scope of the manuals.


> If I understand correctly, you want all tests with
>       doc/.*/.*systemF
> being ignored.

> If that should be so, than OK.
> If not, please help the docs be in good compilable shape.

I see it a bit different:

* The main purpose of the manuals is user documentation. For this,
  compilability to the default output format is required.
  
* Compilability to other formats is a bonus. 

  We try to ensure this for two reasons:
  
  - use as test cases in export tests
  - option for the users to "play" with the document settings
  
  However, if this fails for reasons that cannot be avoided without
  impeding the main purpose (good user documentation), we rather
  invert/ignore a test case.

Unfortunately, the latest set of commits had three sorts of new failures:
true regressions, an unreliable test case, and false regressions.
In this special case, the commit was a "step in the right direction" but
exposed a hidden problem.
  
Proposal for a general rule:

  * regression in standard export formats¹:
  
     1. revert commit
     2. investigate/discuss
     3. solve
     
  * regression in non-standard export:
  
     1. invert test
     2. investigate/discuss
     3. solve

¹ standard export formats for the manuals would be the "default default"
  (currently "ps" if I remember right) and (according to Uwes statement)
  pdf2.
  
  @Uwe: if the manuals are designed for pdflatex export, I suggest to set
  the default output format in the documents. Then we would have just one
  "standard export format".

     
Günter


  

Reply via email to