Change 33538
SDP_Guide.Unix.adoc: make the Classic-structure sample upgrade
procedure work regardless of depot mount point.
Per the user: the sample in 6.3.1.1 hardcoded /mnt/p4depots (the
new default), but customers on the older /hxdepots default have a
habit of blindly copy/pasting this block, so on release day it
would work for zero customers. Reverting to /hxdepots isn't right
either -- it'd start working today but get more wrong over time as
more installs land on the new default.
Fixed by detecting the depot mount point at run time into an
SDPMount variable (via /p4/common's symlink target, same technique
already documented as a manual fallback in this section -- now
built into the main procedure instead of being an afterthought),
so the sample works unmodified whether the mount is /mnt/p4depots,
/hxdepots, or anything else, as long as the standard /p4/common
symlink from the documented install procedure is in place. Removed
the now-redundant "what if there is no /mnt/p4depots" callout and
added a one-line disclaimer that the sample presumes the install
wasn't customized away from the documented structure.
Verified the SDPMount detection against two real, differently-
structured live hosts (a Classic /hxdepots lab and an OS Package
structure host) -- correctly strips to the base mount in both
cases.
Per explicit instruction, NOT regenerating SDP_Guide.Unix.pdf in
this change (HTML regenerated; PDF left alone).
Agent: Claude (Sonnet 5), on behalf of Tom Tyler.
procedure work regardless of depot mount point.
Per the user: the sample in 6.3.1.1 hardcoded /mnt/p4depots (the
new default), but customers on the older /hxdepots default have a
habit of blindly copy/pasting this block, so on release day it
would work for zero customers. Reverting to /hxdepots isn't right
either -- it'd start working today but get more wrong over time as
more installs land on the new default.
Fixed by detecting the depot mount point at run time into an
SDPMount variable (via /p4/common's symlink target, same technique
already documented as a manual fallback in this section -- now
built into the main procedure instead of being an afterthought),
so the sample works unmodified whether the mount is /mnt/p4depots,
/hxdepots, or anything else, as long as the standard /p4/common
symlink from the documented install procedure is in place. Removed
the now-redundant "what if there is no /mnt/p4depots" callout and
added a one-line disclaimer that the sample presumes the install
wasn't customized away from the documented structure.
Verified the SDPMount detection against two real, differently-
structured live hosts (a Classic /hxdepots lab and an OS Package
structure host) -- correctly strips to the base mount in both
cases.
Per explicit instruction, NOT regenerating SDP_Guide.Unix.pdf in
this change (HTML regenerated; PDF left alone).
Agent: Claude (Sonnet 5), on behalf of Tom Tyler.