[xsd-users] Tool for documenting/visualizing C++ Tree Output

[Iain Sharp]

Thanks - that's a shame, but at least I understand why it isn't appearing!

Related to this, it may be helpful to add a few more comments to your interface example in section 2.8.2 of the C++/Tree User Manual. A few things weren't obvious to me on a first reading. Here is my proposal:

"  // Get/set interface.
  //
public:
  // Check if an element is present or not
  bool
  present () const;
  // Get an element if it is present - an error otherwise
  const X&
  get () const;
  // Get an element if it is present - an error otherwise
  X&
  get ();
  // Makes a deep copy.
  //
  void
  set (const X&);
  // Assumes ownership.
  //
  void
  set (std::[auto|unique]_ptr<X>);
  // Detach and return the contained value.
  //
  std::[auto|unique]_ptr<X>
  detach ();
  // Delete an element
  void
  reset ();
};"


Regards

Iain


-----Original Message-----
From: Boris Kolpackov [mailto:boris at codesynthesis.com] 
Sent: 11 December 2017 14:11
To: Iain Sharp <isharp at atis.org>
Cc: xsd-users at codesynthesis.com
Subject: Re: [xsd-users] Tool for documenting/visualizing C++ Tree Output

Iain Sharp <isharp at atis.org> writes:

> In this example, the App_ID_optional isn't documented except as an 
> instance of the templated type which itself doesn't seem to appear in 
> the Doxygen output.

Yes, optional (as well as sequence) haven't been documented yet.

Boris