sycl namespace

[mkinsner]

The reference assumes using namespace sycl; in synopses and text.

@keryell suggested that instead namespaces should be explicit everywhere. Should we make them explicit in both the code snips and all the text within SYCL_Reference, or only in the code snips?

Currently we're mixing styles. For example:

[gmlueck]

We could expand the synopsis at the top of the page. For example, old is:

class platform;

New could be:

namespace sycl {

class platform {
 public:
  platform();

  template <typename DeviceSelector> explicit platform(const DeviceSelector&);

  backend get_backend() const noexcept;

  template <typename Param>
  typename Param::return_type get_info() const;

  template <typename Param>
  typename Param::return_type get_backend_info() const;

  bool has(sycl::aspect asp) const;

  bool has_extension(const std::string& extension) const;

  std::vector<device> get_devices(info::device_type deviceType = info::device_type::all) const;

  static std::vector<platform> get_platforms();
};

} // namespace sycl

Of course, this causes the synopsis to have duplicate declarations of all the member functions shown later in the page. Is that what you had in mind?