← Back to branch summary

~brandontschaefer/mir/first-round-deprecation

« back to all changes in this revision

Viewing changes to include/client/mir_toolkit/mir_connection.h

  • Committer: Brandon Schaefer
  • Date: 2016-12-13 18:06:42 UTC
  • Revision ID: brandon.schaefer@canonical.com-20161213180642-yubpqwzhbx2lrpk4
* Dont say we are deprecated in the documentation until we are

Show diffs side-by-side

added added

removed removed

Lines of Context:
include/client/mir_toolkit/mir_connection.h
90
90
 * Query platform-specific data and/or file descriptors that are required to
91
91
 * initialize GL/EGL features.
92
92
 *
93
 
 * FIXME Need to wait for replacement
94
 
 * \deprecated Use "get_platform" extension
 
93
 * FIXME Waiting for "get_platform" extension
95
94
 *
96
95
 *   \param [in]  connection        The connection
97
96
 *   \param [out] platform_package  Structure to be populated
101
100
/**
102
101
 * Query graphics platform module.
103
102
 *
104
 
 * FIXME Need to wait for replacement
105
 
 * \deprecated Use "get_graphics_module" extension
 
103
 * FIXME Waiting for "get_graphics_module" extension
106
104
 * \note The char pointers in MirModuleProperties are owned by the connection and should not be
107
105
 * freed. They remain valid until the connection is released.
108
106
 *
153
151
 * Query the display
154
152
 *
155
153
 *   // FIXME Waiting for mir_connection_apply_display_configuration(...)
156
 
 *   \deprecated  See mir_connection_create_display_configuration()
157
154
 *
158
155
 *   \warning return value must be destroyed via mir_display_config_destroy()
159
156
 *   \warning may return null if connection is invalid
196
193
/**
197
194
 * Apply the display configuration
198
195
 *
199
 
 * // FIXME Waiting for replacement
200
 
 * \deprecated Replace with mir_connection_apply_display_configuration(...)
 
196
 * // FIXME Waiting for mir_connection_apply_display_configuration(...)
201
197
 *
202
198
 * The display configuration is applied to this connection only (per-connection
203
199
 * configuration) and is invalidated when a hardware change occurs. Clients should
214
210
/**
215
211
 * Set the base display configuration
216
212
 *
217
 
 * // FIXME Waiting for mir_connection_apply_display_configuration(...)
218
 
 * \deprecated Use mir_connection_preview_base_display_configuration/mir_connection_confirm_base_display_configuration
 
213
 * // FIXME Waiting for mir_connection_preview_base_display_configuration/mir_connection_confirm_base_display_configuration
219
214
 *
220
215
 * The base display configuration is the configuration the server applies when
221
216
 * there is no active per-connection configuration.
356
351
/**
357
352
 * Perform a platform specific operation.
358
353
 *
359
 
 * // FIXME Waiting for replacement
360
 
 * \deprecated Use the platform extensions API instead
 
354
 * // FIXME Waiting for the platform extensions API instead
361
355
 *
362
356
 * The MirPlatformMessage used for the request needs to remain valid
363
357
 * until this operation finishes.