Bug 26835 - Prune outdated non-spec from telepathy-spec package
Summary: Prune outdated non-spec from telepathy-spec package
Status: RESOLVED FIXED
Alias: None
Product: Telepathy
Classification: Unclassified
Component: tp-spec (show other bugs)
Version: unspecified
Hardware: Other All
: medium normal
Assignee: Simon McVittie
QA Contact: Telepathy bugs list
URL: http://git.collabora.co.uk/?p=user/sm...
Whiteboard: review+
Keywords: patch
: 30468 (view as bug list)
Depends on:
Blocks: 31505
  Show dependency treegraph
 
Reported: 2010-03-02 01:45 UTC by Olivier Le Thanh Duong
Modified: 2010-11-10 05:46 UTC (History)
1 user (show)

See Also:
i915 platform:
i915 features:


Attachments

Description Olivier Le Thanh Duong 2010-03-02 01:45:11 UTC
Certain places of the telepathy-spec refer to use cases. For exemple http://telepathy.freedesktop.org/spec/org.freedesktop.Telepathy.Client.Handler.html#org.freedesktop.Telepathy.Client.Handler.BypassApproval contain a note: (This is use-case dis5)
However there is no explanation of what theses uses cases are or where to find them. It would be nice if there was a link to the specific use case when they are mentioned.
Comment 1 Simon McVittie 2010-03-02 06:47:19 UTC
(In reply to comment #0)
> Certain places of the telepathy-spec refer to use cases.

These were part of the design process for the ChannelDispatcher (doc/*.txt). To be honest, I think the best way to resolve this bug would be to explain these use cases (briefly, where relevant) in the spec text, and get rid of doc/*.txt.
Comment 2 Simon McVittie 2010-11-09 08:54:49 UTC
Repurposing this bug somewhat for some work I did recently:

* delete the "use cases" lists, which are rather out of date (I filed bugs for those that aren't well enough explained or satisfied)

* delete the reference olethanh noticed, which doesn't really add value

* delete obsolete codegen tools and their tests

* un-bit-rot test/test-specparser.py and make it run in "make check"

* add distclean, maintainer-clean and a stub for distdir

This was meant to be working towards having telepathy-spec usable as a submodule in telepathy-glib, but that won't work until/unless we support out-of-tree builds, so I'll clone a bug for that.
Comment 3 Simon McVittie 2010-11-09 09:08:27 UTC
*** Bug 30468 has been marked as a duplicate of this bug. ***
Comment 4 Jonny Lamb 2010-11-09 09:13:11 UTC
Looks good if everything still works.
Comment 5 Simon McVittie 2010-11-10 05:46:49 UTC
Seems to work, so, fixed in git for 0.21.5


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.