Bug 72265

Summary:	High-level documentation missing for creating streams with pa_stream_new_extended()
Product:	PulseAudio	Reporter:	Tanu Kaskinen <tanuk>
Component:	misc	Assignee:	pulseaudio-bugs
Status:	RESOLVED MOVED	QA Contact:	pulseaudio-bugs
Severity:	normal
Priority:	medium	CC:	lennart
Version:	unspecified
Hardware:	Other
OS:	All
Whiteboard:
i915 platform:		i915 features:

Description Tanu Kaskinen 2013-12-03 13:22:06 UTC

We have high-level documentation on how to create streams with pa_stream_new(): http://freedesktop.org/software/pulseaudio/doxygen/streams.html

We should also have high-level documentation for creating streams with pa_stream_new_extended(), i.e. explain how the formats should be constructed and how the format negotiation works, and what to do when the stream moves (IIRC there were some special tricks required from the application to manage the moving gracefully).

Comment 1 nfxjfg 2014-10-23 15:12:07 UTC

I could need this information. Am I supposed to reverse engineer gstreamer or something?

Just get the Poettering and constrain him to a room, and leave him out only after he replaced the link to this bug in the documentation with actual documentation.

Comment 2 Arun Raghavan 2014-10-23 17:21:46 UTC

(In reply to nfxjfg from comment #1)
> I could need this information. Am I supposed to reverse engineer gstreamer
> or something?

For now, you can ping me on IRC (Ford_Prefect), since I wrote most of this code.

> Just get the Poettering and constrain him to a room, and leave him out only
> after he replaced the link to this bug in the documentation with actual
> documentation.

This space is not intended for personal attacks (and they'd be in poor taste anywhere). If you want people to take you seriously and be helpful, refrain from such comments.

Comment 3 Arun Raghavan 2014-10-23 17:22:10 UTC

There is some preliminary design documentation on the API here: http://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/Developer/Passthrough/

Could be extended to add the missing information.

Comment 4 GitLab Migration User 2018-07-30 10:29:33 UTC

-- GitLab Migration Automatic Message --

This bug has been migrated to freedesktop.org's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.freedesktop.org/pulseaudio/pulseaudio/issues/461.

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.