bugmake - Bugs: bug #61321, Extend the Overview chapter

 
 

bug #61321: Extend the Overview chapter

Submitter:  None
Submitted:  Sat 09 Oct 2021 03:34:54 PM UTC
   
 
Severity:  3 - Normal Priority:  5 - Normal
Item Group:  Documentation Status:  None
Privacy:  Public Assigned to:  None
Open/Closed:  Open Component Version:  None
Operating System:  None Fixed Release:  None
Triage Status:  None
* Mandatory Fields

Post a Comment

Add a New Comment Rich Markup
   

Discussion

Sat 09 Oct 2021 03:34:54 PM UTC, original submission:  

I'm kindly offering this proposal for the Overview chapter. Feel
free to reword it, or use it in any way, shape, or form.

As per the commit message:

I spent a surprising amount of time pondering what the hell is going
on, when I have had already run and edited countless Makefiles.  The
manual is large, and it's an enormous amount of effort to extract this
understanding from it, especially when you just want to quickly
compile something, but it fails.

I believe that these few sentences have a very high value/time ratio
for someone who has just saw their very first Makefile in their lives.
Keep in mind that each day there are untold number of children who try
to compile something for the first time in their lives... but then it
fails.

  • doc/make.texi (Overview): give a slightly extended bird's eye view.



Anonymous

 

Attached Files

Attached Files
file #52088:  0001-Extend-the-Overview-chapter-in-the-documentation.patch added by None (3.4KiB - text/x-patch - revised patch (trivial changes))

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

Attach Files:
   
   
Comment:
   

 

Dependencies

This item does not depend on any other items.

No items depend on this one.

 

Mail Notification Carbon-Copy List

 

Votes

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.

 

Please enter the title of George Orwell's famous dystopian book (it's a date):

History

Follow 2 latest changes.

Date Changed by Updated Field Previous Value => Replaced by
2021-10-10 None Attached File- Added 0001-Extend-the-Overview-chapter-in-the-documentation.patch, #52088
2021-10-09 None Attached File- Added 0001-Extend-the-Overview-chapter-in-the-documentation.patch, #52083

Back to the top

Powered by Savane 3.16-598c.
Corresponding source code