fwd: Re: docs/117593: icase and www make search variables aren't documented in ports man page

[Denis Barov]

----- Forwarded message from Denis Barov <dindin at yandex-team.ru> -----

Date: Mon, 29 Oct 2007 17:21:24 +0300
From: Denis Barov <dindin at yandex-team.ru>
To: Nikolay Bachiyski <nbachiyski at developer.bg>
Subject: Re: docs/117593: icase and www make search variables aren't documented in ports man page
Message-ID: <20071029142124.GA1430 at sepulcator.local.yandex.ru>
References: <200710281020.l9SAKIbV019415 at www.freebsd.org>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha1;
	protocol="application/pgp-signature"; boundary="OXfL5xGRrasGEqWY"
Content-Disposition: inline
In-Reply-To: <200710281020.l9SAKIbV019415 at www.freebsd.org>
X-Operating-System: FreeBSD sepulcator.local.yandex.ru 7.0-PRERELEASE FreeBSD 7.0-PRERELEASE
User-Agent: mutt-ng/devel-r804 (FreeBSD)
Status: RO
Content-Length: 4267
Lines: 136

On Sun Oct 28, 2007 at 10:20:18 +0000, Nikolay Bachiyski wrote:
> 
> >Number:         117593
> >Category:       docs
> >Synopsis:       icase and www make search variables aren't documented in ports man page
> >Confidential:   no
> >Severity:       non-critical
> >Priority:       low
> >Responsible:    freebsd-doc
> >State:          open
> >Quarter:        
> >Keywords:       
> >Date-Required:
> >Class:          doc-bug
> >Submitter-Id:   current-users
> >Arrival-Date:   Sun Oct 28 10:30:01 UTC 2007
> >Closed-Date:
> >Last-Modified:
> >Originator:     Nikolay Bachiyski
> >Release:        FreeBSD 7.0-BETA1.5
> >Organization:
> >Environment:
> >Description:
> make search accepts two variables, which aren't documented:
> * www -- searches in the port web site
> * icase -- ignore case, helps case-sensitive searches
> >How-To-Repeat:
> 
> >Fix:
> A patch for HEAD is applied.
> 
> Patch attached with submission follows:
> 
> --- ports.7.orig	Wed Aug 22 21:11:26 2007
> +++ ports.7	Sun Oct 28 11:52:13 2007
> @@ -274,7 +274,9 @@
>  .Va bdeps
>  (searches the port build-time dependency),
>  .Va rdeps
> -(searches the port run-time dependency)
> +(searches the port run-time dependency),
> +.Va www
> +(searches the port web site)
>  .Xr make 1
>  variables, and their exclusion counterparts:
>  .Va xname , xkey
> @@ -317,6 +319,14 @@
>  .Dq Li apache
>  in either of the name, path, info
>  fields, ignore the rest of the record.
> +.Pp
> +By default the search is case-insensitive. In order to
> +make it case-sensitive you can use the
> +.Va icase
> +variable:
> +.Bd -literal -offset indent
> +make search name=p5-R icase=0
> +.Ed
>  .It Cm quicksearch
>  Reduced
>  .Cm search
> 
> 
> >Release-Note:
> >Audit-Trail:
> >Unformatted:
> _______________________________________________
> freebsd-doc at freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"

As we can see in ports/Mk/bsd.port.subdir.mk there a alot of undocumented
options:

    cd ${PORTSDIR}; \
    if [ -z "$$key"   -a -z "$$xkey"   -a \
         -z "$$name"  -a -z "$$xname"  -a \
         -z "$$path"  -a -z "$$xpath"  -a \
         -z "$$info"  -a -z "$$xinfo"  -a \
         -z "$$maint" -a -z "$$xmaint" -a \
         -z "$$cat"   -a -z "$$xcat"   -a \
         -z "$$bdeps" -a -z "$$xbdeps" -a \
         -z "$$rdeps" -a -z "$$xrdeps" -a \
         -z "$$www"   -a -z "$$xwww"   ]; \
    then \
      ${ECHO_MSG} "The ${.TARGET} target requires a keyword parameter or
name parameter,"; \
      ${ECHO_MSG} "e.g.: \"make ${.TARGET} key=somekeyword\""; \
      ${ECHO_MSG} "or    \"make ${.TARGET} name=somekeyword\""; \
      exit; \
    fi; \
    ${AWK} -F\| -v there="$$here/" -v top="$$(pwd -P)" \
        -v key="$$key"          -v xkey="$$xkey" \
        -v name="$$name"        -v xname="$$xname" \
        -v path="$$path"        -v xpath="$$xpath" \
        -v info="$$info"        -v xinfo="$$xinfo" \
        -v maint="$$maint"      -v xmaint="$$xmaint" \
        -v cat="$$cat"          -v xcat="$$xcat" \
        -v bdeps="$$bdeps"      -v xbdeps="$$xbdeps" \
        -v rdeps="$$rdeps"      -v xrdeps="$$xrdeps" \
        -v www="$$www"          -v xwww="$$xwww" \
        -v icase="$${icase:-${PORTSEARCH_IGNORECASE}}" \
        -v keylim="$${keylim:-${PORTSEARCH_KEYLIM}}" \
        -v xkeylim="$${xkeylim:-${PORTSEARCH_XKEYLIM}}" \
        -v display="$${display:-${PORTSEARCH_DISPLAY_FIELDS}}" \
        -v xdisplay="$$xdisplay" 


-- 
Denis Barov
Yandex http://www.yandex.ru
WEB-Search Administtration Team
e-mail: dindin at yandex-team.ru



----- End forwarded message -----