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 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

Add a New Comment Rich Markup
   

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

 

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

Attach Files:
   
   
Comment:
   

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

 

Depends on the following items: None found

Items that depend on this one: None found

 

CC list is empty

 

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 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.14-49f2.
Corresponding source code