From mboxrd@z Thu Jan  1 00:00:00 1970
From: Ian Campbell <ian.campbell@citrix.com>
Subject: Re: [PATCH] build: update top-level make help
Date: Wed, 2 Sep 2015 15:26:40 +0100
Message-ID: <1441204000.26292.216.camel@citrix.com>
References: <1441138208-851-1-git-send-email-cardoe@cardoe.com>
	<55E6C13602000078000D7CB1@prv-mh.provo.novell.com>
	<CAFWqQMR-hcEDhovrg6A9A-0CpZxY4Yi5YTytg=r3iuPkTjoOqg@mail.gmail.com>
	<55E7126E020000780009EFCE@prv-mh.provo.novell.com>
	<1441200854.26292.195.camel@citrix.com>
	<55E7207C020000780009F0E4@prv-mh.provo.novell.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Return-path: <xen-devel-bounces@lists.xen.org>
In-Reply-To: <55E7207C020000780009F0E4@prv-mh.provo.novell.com>
List-Unsubscribe: <http://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <http://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Sender: xen-devel-bounces@lists.xen.org
Errors-To: xen-devel-bounces@lists.xen.org
To: Jan Beulich <JBeulich@suse.com>
Cc: Ian Jackson <ian.jackson@eu.citrix.com>, Tim Deegan <tim@xen.org>, Keir Fraser <keir@xen.org>, Doug Goldstein <cardoe@cardoe.com>, xen-devel@lists.xen.org
List-Id: xen-devel@lists.xenproject.org

On Wed, 2015-09-02 at 08:14 -0600, Jan Beulich wrote:
> > 
> > > > On 02.09.15 at 15:34, <ian.campbell@citrix.com> wrote:
> > On Wed, 2015-09-02 at 07:14 -0600, Jan Beulich wrote:
> > > > > > On 02.09.15 at 15:09, <cardoe@cardoe.com> wrote:
> > > > On Wed, Sep 2, 2015 at 3:28 AM, Jan Beulich <jbeulich@suse.com> 
> > > > wrote:
> > > > > > > > Doug Goldstein <cardoe@cardoe.com> 09/01/15 10:10 PM >>>
> > > > > > --- a/Makefile
> > > > > > +++ b/Makefile
> > > > > > @@ -228,16 +228,23 @@ help:
> > > > > > @echo '  install-stubdom       - build and install the 
> > > > > > stubdomain 
> > > > > > images'
> > > > > > @echo '  install-docs          - build and install user 
> > > > > > documentation'
> > > > > > @echo ''
> > > > > > -      @echo 'Building targets:'
> > > > > > +      @echo 'Local dist targets:'
> > > > > > @echo '  dist                  - build and install everything 
> > > > > > into 
> > > > > > local dist directory'
> > > > > > @echo '  world                 - clean everything then make 
> > > > > > dist'
> > > > > > -      @echo '  xen                   - build and install Xen 
> > > > > > hypervisor'
> > > > > > -      @echo '  tools                 - build and install 
> > > > > > tools'
> > > > > > -      @echo '  stubdom               - build and install the 
> > > > > > stubdomain images'
> > > > > > -      @echo '  docs                  - build and install user 
> > > > > > documentation'
> > > > > 
> > > > > Why are these being removed? At least the xen and tools ones work 
> > > > > 
> > > > > fine for me.
> > > > 
> > > > In the makefile they're marked as "legacy" and they are wired 
> > > > straight
> > > > to their "dist-" equivalents.
> > > 
> > > But still they're there and they work (and they're faster to type 
> > > than
> > > their "dist-" equivalents).
> > 
> > If they are legacy then it is correct to not list them here.
> 
> Hmm - why does "legacy" imply "not documented here"?

Legacy means "deprecated" and/or "not encouraged", which to me implies we
should direct users to the non-deprecated alternatives, which also serves
to make the list of potential targets in the help less overwhelming.

> But anyway - I don't mean to stand in the way of you committing the
> patch as is, as long as those (legacy) build targets don't go away.
> 
> Jan
>