Opened 15 months ago

Last modified 6 days ago

#66687 assigned defect

*-bootstrap ports: Remove notes???

Reported by: ryandesign (Ryan Carsten Schmidt) Owned by: nobody
Priority: Normal Milestone:
Component: ports Version:
Keywords: Cc:
Port: gcc10-bootstrap, clang-11-bootstrap

Description

Installing the cmake-bootstrap port causes these notes to be printed:

  cmake-bootstrap has the following notes:
    To use this bootstrap version of cmake instead of the usual cmake port, add
    the following lines to the Portfile:
    
    depends_build-replace  path:bin/cmake:cmake port:cmake-bootstrap
    configure.cmd          ${prefix}/libexec/cmake-bootstrap/bin/cmake

These notes are intended for port developers and seem likely to confuse users who just want to use ports that happen to have a dependency on cmake-bootstrap. Port notes in general are intended for giving information to users, not developers. It might be nice if MacPorts had a "developer mode" that developers could opt into to see such additional information (there could be a new devnotes command where such information could be left, and which would not be printed unless the user opted into developer mode) but no such mode exists at this time. Perhaps the information in this port's notes could be changed to comments in the Portfile, under the assumption that a developer might read the contents of dependency's Portfile when developing another port.

Change History (7)

comment:1 Changed 10 months ago by kencu (Ken)

Owner: set to kencu
Resolution: fixed
Status: newclosed

In 39d4620712d7f16bb3dd4f05d468b2485c1ae9f3/macports-ports (master):

cmake-bootstrap: remove usage notes

Ryan requested these be removed.
closes: #66687

comment:2 Changed 5 months ago by kencu (Ken)

Port: xz-bootstrap gcc10-bootstrap clang-11-bootstrap added
Resolution: fixed
Status: closedreopened
Summary: cmake-bootstrap: Remove notes*-bootstrap ports: Remove notes???

I noticed all the other bootstrap ports (xz-bootstrap, gcc10-bootstrap, etc, etc) all have notes like this one used to have, so for consistency I guess those ports should all remove their usage notes too.

Although figuring out how to use them might be hard, unless they are all left as comments in the portfiles...

comment:3 Changed 5 months ago by kencu (Ken)

Owner: changed from kencu to nobody
Status: reopenedassigned

comment:4 Changed 5 months ago by catap (Kirill A. Korinsky)

Ken, maybe convert notes into comment?

comment:5 Changed 6 days ago by Ken <21211439+kencu@…>

In ddb8e007fcc01dcf174d835aebd7c369511d5371/macports-ports (master):

xz-bootstrap: remove needless notes

see: #66687

comment:6 Changed 6 days ago by kencu (Ken)

Port: xz-bootstrap removed

comment:7 Changed 6 days ago by kencu (Ken)

Port: cmake-bootstrap removed
Note: See TracTickets for help on using tickets.