[MacPorts] #65182: An easy to correct error in the install from sources documentation

[MacPorts]

#65182: An easy to correct error in the install from sources documentation
----------------------------+--------------------
  Reporter:  AbcMediumRepo  |      Owner:  (none)
      Type:  defect         |     Status:  new
  Priority:  Low            |  Milestone:
 Component:  guide          |    Version:  2.7.2
Resolution:                 |   Keywords:
      Port:                 |
----------------------------+--------------------
Changes (by ryandesign):

 * component:  ports => guide


Old description:

> Hello everybody,
>
> Thank you all for your great software!
> I found a little error in the install documentation, in
> https://guide.macports.org/#installing.macports.source
> I had rebuild the sources from a git clone, so I need to change
> /opt/local/etc/macports/sources.conf
>
> In
> "(Optional) Configure MacPorts to use port information from Git
>
> This step is useful if you want to do port development. Check out the
> ports tree from git:
>
> $ cd /opt/mports
> $ git clone https://github.com/macports/macports-ports.git
> Then open /opt/local/etc/macports/sources.conf in a text editor. The last
> line should look like this:
>
> rsync://rsync.macports.org/macports/release/tarballs/ports.tar [default]
> Change it to point to the working copy you checked out:
>
> file:///opt/mports/macports-ports [default]
> Now MacPorts will look for portfiles in the working copy and use Git
> instead of rsync to update your ports tree.
> "
>
> file:///opt/mports/macports-ports [default] is wrong because the line up
> have been changed, I suppose.
> The right content for this /opt/local/etc/macports/sources.conf is, at
> the end of the file:
> file:///opt/mports/macports-base/ [default]
>
> macports-base is good, macports-ports was wrong for me.
>
> Hope it helps,
>
> Best regards,
>
> Tristan Guez

New description:

 Hello everybody,

 Thank you all for your great software!
 I found a little error in the install documentation, in
 https://guide.macports.org/#installing.macports.source
 I had rebuild the sources from a git clone, so I need to change
 /opt/local/etc/macports/sources.conf

 In
 > 3. (Optional) Configure MacPorts to use port information from Git
 >
 > This step is useful if you want to do port development. Check out the
 ports tree from git:
 >
 > {{{
 > $ cd /opt/mports
 > $ git clone https://github.com/macports/macports-ports.git
 > }}}
 >
 > Then open /opt/local/etc/macports/sources.conf in a text editor. The
 last line should look like this:
 >
 > {{{
 > rsync://rsync.macports.org/macports/release/tarballs/ports.tar [default]
 > }}}
 >
 > Change it to point to the working copy you checked out:
 >
 > {{{
 > file:///opt/mports/macports-ports [default]
 > }}}
 >
 > Now MacPorts will look for portfiles in the working copy and use Git
 instead of rsync to update your ports tree.

 `file:///opt/mports/macports-ports [default]` is wrong because the line up
 have been changed, I suppose.
 The right content for this /opt/local/etc/macports/sources.conf is, at the
 end of the file:
 `file:///opt/mports/macports-base/ [default]`

 `macports-base` is good, `macports-ports` was wrong for me.

 Hope it helps,

 Best regards,

 Tristan Guez

--

Comment:

 I don't see how your suggestion could be correct. The documentation is
 correct as written. sources.conf must point to the place where your ports
 tree is, such as a clone of macports-ports. It makes no sense to point it
 at a clone of macports-base.

-- 
Ticket URL: <https://trac.macports.org/ticket/65182#comment:1>
MacPorts <https://www.macports.org/>
Ports system for macOS