LSB Futures Tracker Administration
LSB Futures Tracker Administration
Note: Administration interface is currently available for the 'New Components Tracker' section only.
In order to switch to the LSB Futures Tracker Administration mode, go to the Workgroup Services->Futures Tracker section and press Administration link in the upper right corner.
On the page appeared, one may manage general data about LSB Future Tracker elements.
Adding New Element
In order to add new LSB candidate, in the Add New Entry section you should select appropriate Group, enter element name and its current status. Press Add New Entry button. A new entry should appear in the table with Futures Tracker elements list. Now you can proceed with modifying details of recently added entry.
Modifying Element Details
In order to manage detailed information about some entry, press Modify button in the appropriate row. On the page appeared one may set status of every task of the candidate addition status, as well as the overall status of this process, using predefined values from comboboxes. In order to apply changes, press Apply Changes button.
For every candidate, a link can be specified pointing to the page with detailed explanations of the candidate status. Please refer to the Candidate Page section below on suggestions how such a page could be organizaed.
One may also set target LSB version where the element is going to appear. For elements woth 'completed' status, this value should contain the actual LSB version where the element was added. This field is optional and can be left empty.
In addition, one may select libraries that will be associated with the candidate. Not all the candidates might have libraries associated with them. For example, interpreted languages don't have any. However, it's a common case when LSB candidate is actually a single library or e set of libraries from the same component (e.g. Qt or GTK).
Number of libraries that are currently assigned to the candidate is displayed above the table with candidate properties. Click on the list... link to manage the set of libraries.
Managing Libraries Associated with Element
Modify Set of Libraries section lists sonames of libraries. Press Delete button to break association with a certain library.
In order to add new association, enter apporpriate library soname in the Add New Library section and press Add button. New entry should appear in the list of candidate's libraries.
Note: It is soname of the library that is associated with the candidate, not normal library name. The same library can have different sonames in different distributions, but only one of them is normally considered as LSB candidate. Frequent changes in library soname should be considered as ABI instability; such libraries are not considered as LSB candidate. If unsure which soname should be used (and which sonames exist in the distributions) please check the home page of appropriate library in the LSB Navigartor.
In order to delete some element and all data associated with it from the database, press 'Delete' button in the appropriate row. You will be asked for confirmation if the entry should be really dropped.
Navigator displays brief Futures Tracker information stored in the database. However, there are a lot of relative things for which database is not the best palce to be stored. In particular, a short status of every step displayed by Navigator can be described in details in textual form. To store such texts, it is suggested to use Linux Foundation wiki, which is, in fact, a de facto standard for pages of such kind.
Since the process of adding new entity to LSB involves quite a few steps, it would be nice for the pages for different elements to be organized in the same way. Every page should contain the following sections corresponding to appropriate steps of new entity addition process:
- Best Practice
Navigator uses appropriate anchors to point to page sections corresponding to certain steps.
As an example of the candidate page, one can refer to the AsyncIO page.