Re: [mi] -list-features

[Vladimir Prus <ghost@cs.msu.su>]

On Friday 31 August 2007 12:50:46 Eli Zaretskii wrote:
> > From: Vladimir Prus <ghost@cs.msu.su>
> > Date: Fri, 31 Aug 2007 11:05:37 +0400
> > Cc: drow@false.org,
> >  gdb-patches@sources.redhat.com
> > 
> > How about this:
> > 
> >         -list-features
> >                 Returns a list of particular features of the MI protocol that
> >                 this version of gdb implements.  A feature can be a command,
> >                 or a new field in an output of some command, or even an
> >                 important bugfix.  While a frontend can sometimes detect presence
> >                 of a feature at runtime, it is easier to perform detection at debugger
> >                 startup. 
> > 
> > 		The command returns a list of strings, with each string naming an
> > 		available feature. Each returned string is just a name, it does not
> > 		have any internal structure. The list of possible feature names 
> > 		is given below.
> 
> It is still ambiguous, because "a list of string" does not tell the
> whole story.  Is it
> 
>     foo bar baz
> or
>     "foo" "bar" "baz"
> or
>     foo,bar,baz
> or
>     {foo,bar,baz}

Well, in MI, "list of strings" is quite well defined. But if you like, how about this:

	    -list-features
                Returns a list of particular features of the MI protocol that
                this version of gdb implements.  A feature can be a command,
                or a new field in an output of some command, or even an
                important bugfix.  While a frontend can sometimes detect presence
                of a feature at runtime, it is easier to perform detection at debugger
                startup. 

                The command returns a list of strings, with each string naming an
                available feature. Each returned string is just a name, it does not
                have any internal structure. The list of possible feature names 
                is given below.

		Example output:

			^done,result=["feature1","feature2"]

                The current list of features is:

                - 'frozen-varobjs' -- indicates presence of -var-set-frozen command,
                as well as possible presense of the 'frozen' field in the output of
                -varobj-create.

- Volodya