bugGNU troff - Bugs: bug #62541, in-tree documents should make(1)...

 
 

bug #62541: in-tree documents should make(1) depend on macro files they explicitly use

Submitter:  None
Submitted:  Mon 30 May 2022 02:42:30 AM UTC
 
Category:  General Severity:  3 - Normal
Item Group:  Build/Installation Status:  Confirmed
Privacy:  Public Assigned to:  gbranden
Open/Closed:  Open Planned Release:  None
* Mandatory Fields

Add a New Comment (Rich Markup)
   

Comment Type & Canned Response:
       No canned response available

 

Mon 30 May 2022 05:50:10 PM UTC, comment #2: 

This was a deliberate choice; I was going to close this ticket as invalid.

My reasoning was that because the macro files are part of the source distribution, nothing cleans them and they are therefore "guaranteed to exist", barring careless destruction by the person building.

However, on reflection, this stance is not consistent with the way Makefiles are generally written.  .o files depend on .c files (that are part of source distributions) all the time.

Further, when undertaking changes to the macro files themselves, the documents that use them should be rebuilt.  This is one way that errors in development can be caught swiftly.

So I'll do this.

G. Branden Robinson <gbranden>
Project Administrator
Mon 30 May 2022 02:46:56 AM UTC, comment #1: 

  Forgot to login

Bjarni Ingi Gislason <bjarniig>
Mon 30 May 2022 02:42:30 AM UTC, original submission:  

Subject: Makefile: creation of man pages is not let to depend on the
used macros

  Lines with "-m" do not have a prerequisite for the used macro file,
for example

doc/groff-man-pages.pdf: $(GROFF_MAN_PAGES_ALL) eqn pic tbl
        $(GROFF_V)$(DOC_GROFF) -pet -Tpdf -P-e -mandoc -rC1 \

  Here "mandoc" uses at least "tmac/an.tmac" or "tmac/doc.tmac".

Anonymous

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by gbranden (Posted a comment)
  • -email is unavailable- added by bjarniig (Posted a comment)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

     

     

     

    Follow 4 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-06-01 gbranden StatusIn Progress Confirmed
    2022-05-30 gbranden SummaryMakefile: creation of man pages is not let to depend on the used macros in-tree documents should make(1) depend on macro files they explicitly use
    2022-05-30 gbranden StatusNone In Progress
        Assigned toNone gbranden

    Back to the top


    Powered by Savane 3.9