Ticket #9673 (new enhancement)

Opened 3 years ago

Last modified 3 years ago

Referring to flag for doc-testing only changed files

Reported by: jsrn Owned by: mvngu
Priority: minor Milestone:
Component: documentation Keywords: doctest
Cc: Work issues:
Report Upstream: N/A Reviewers:
Authors: jsrn Merged in:
Dependencies: Stopgaps:

Description

In the Developer's Guide there is no reference to the "-tnew" flag to the sage executable, which will instruct Sage to only doctest changed files. I suggest adding such a reference in "Walking through the development process" as well as "Parallel Testing the Sage Library".

Change History

comment:1 Changed 3 years ago by jsrn

Does anyone know how the "-tnew" flag works in detail? In particular, does it doctest every file that has been changed as well as its dependencies? If it is the case, this should be mentioned in the documentation. Otherwise, shouldn't it?

comment:2 Changed 3 years ago by jsrn

Of course, the above shouldn't say "its dependencies" but rather "the files depending on them".

Note: See TracTickets for help on using tickets.