diff options
| author | Gordon Bergling <gbe@FreeBSD.org> | 2022-08-07 12:53:53 +0000 |
|---|---|---|
| committer | Gordon Bergling <gbe@FreeBSD.org> | 2022-08-10 12:22:26 +0000 |
| commit | b83d5bf050a9c735c9f6079672d5af3dec24b7dd (patch) | |
| tree | e318616b1bf721b28d92a72ae370b4acc1727c0b /lib/libpathconv | |
| parent | 876ecdd30c74e30483b68b47a7dc6bbb40109e27 (diff) | |
Diffstat (limited to 'lib/libpathconv')
| -rw-r--r-- | lib/libpathconv/abs2rel.3 | 44 | ||||
| -rw-r--r-- | lib/libpathconv/rel2abs.3 | 40 |
2 files changed, 42 insertions, 42 deletions
diff --git a/lib/libpathconv/abs2rel.3 b/lib/libpathconv/abs2rel.3 index 984b2530e1b0..fd684aa072d9 100644 --- a/lib/libpathconv/abs2rel.3 +++ b/lib/libpathconv/abs2rel.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd Dec 15, 1997" +.Dd December 15, 1997 .Dt ABS2REL 3 .Os .Sh NAME @@ -60,6 +60,23 @@ function returns relative path name on success. If an error occurs, it returns .Dv NULL . +.Sh EXAMPLES + char result[MAXPATHLEN]; + char *path = abs2rel("/usr/src/sys", "/usr/local/lib", result, MAXPATHLEN); + +yields: + + path == "../../src/sys" + +Similarly, + + path1 = abs2rel("/usr/src/sys", "/usr", result, MAXPATHLEN); + path2 = abs2rel("/usr/src/sys", "/usr/src/sys", result, MAXPATHLEN); + +yields: + + path1 == "src/sys" + path2 == "." .Sh ERRORS The .Fn abs2rel @@ -77,24 +94,11 @@ argument is zero. The .Fa size argument is greater than zero but smaller than the length of the pathname plus 1. -.Sh EXAMPLE - char result[MAXPATHLEN]; - char *path = abs2rel("/usr/src/sys", "/usr/local/lib", result, MAXPATHLEN); - -yields: - - path == "../../src/sys" - -Similarly, - - path1 = abs2rel("/usr/src/sys", "/usr", result, MAXPATHLEN); - path2 = abs2rel("/usr/src/sys", "/usr/src/sys", result, MAXPATHLEN); - -yields: - - path1 == "src/sys" - path2 == "." +.Sh SEE ALSO +.Xr rel2abs 3 +.Sh AUTHORS +.An Shigio Yamaguchi (shigio@tamacom.com) .Sh BUGS If the .Fa base @@ -130,7 +134,3 @@ The function assures correct result, but don't forget that .Fn realpath requires that all but the last component of the path exist. -.Sh "SEE ALSO" -.Xr rel2abs 3 -.Sh AUTHORS -Shigio Yamaguchi (shigio@tamacom.com) diff --git a/lib/libpathconv/rel2abs.3 b/lib/libpathconv/rel2abs.3 index aee8039cf914..8bc880707d7b 100644 --- a/lib/libpathconv/rel2abs.3 +++ b/lib/libpathconv/rel2abs.3 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd Dec 3, 1997" +.Dd December 3, 1997 .Dt REL2ABS 3 .Os .Sh NAME @@ -58,6 +58,23 @@ The function returns absolute path name on success. If an error occurs, it returns .Dv NULL . +.Sh EXAMPLES + char result[MAXPATHLEN]; + char *path = rel2abs("../../src/sys", "/usr/local/lib", result, MAXPATHLEN); + +yields: + + path == "/usr/src/sys" + +Similarly, + + path1 = rel2abs("src/sys", "/usr", result, MAXPATHLEN); + path2 = rel2abs(".", "/usr/src/sys", result, MAXPATHLEN); + +yields: + + path1 == "/usr/src/sys" + path2 == "/usr/src/sys" .Sh ERRORS The .Fn rel2abs @@ -75,24 +92,7 @@ argument is zero. The .Fa size argument is greater than zero but smaller than the length of the pathname plus 1 -.Sh EXAMPLE - char result[MAXPATHLEN]; - char *path = rel2abs("../../src/sys", "/usr/local/lib", result, MAXPATHLEN); - -yields: - - path == "/usr/src/sys" - -Similarly, - - path1 = rel2abs("src/sys", "/usr", result, MAXPATHLEN); - path2 = rel2abs(".", "/usr/src/sys", result, MAXPATHLEN); - -yields: - - path1 == "/usr/src/sys" - path2 == "/usr/src/sys" -.Sh "SEE ALSO" +.Sh SEE ALSO .Xr abs2rel 3 .Sh AUTHORS -Shigio Yamaguchi (shigio@tamacom.com) +.An Shigio Yamaguchi (shigio@tamacom.com) |