Hi there, The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side. If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode. Please tell me what you think. Guillaume -- Live fast, die old, and make very sure everyone knows you were there. -- Alan Cox
On Tuesday, 23 August 2005 at 23:40, Guillaume POIRIER wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode.
Please tell me what you think.
There's nothing to tell, the attachment is empty. ;) -- MPlayer RPMs maintainer: http://rpm.greysector.net/mplayer/ "I am Grey. I stand between the candle and the star. We are Grey. We stand between the darkness ... and the light." -- Delenn in Grey Council in Babylon 5:"Babylon Squared"
Hi, On 8/23/05, Dominik 'Rathann' Mierzejewski <dominik@rangers.eu.org> wrote:
On Tuesday, 23 August 2005 at 23:40, Guillaume POIRIER wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode.
Please tell me what you think.
There's nothing to tell, the attachment is empty. ;)
Arf! At least, I attached smth, contrary the usual mistake that ppl do [good thing I did not attach some confidential document instead BTW :) ] I'll do my best to resend it when I get home. Guillaume -- Live fast, die old, and make very sure everyone knows you were there. -- Alan Cox
On Tue, Aug 23, 2005 at 11:40:13PM +0200, Guillaume POIRIER wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode.
Please tell me what you think.
Well you asked... I don't really like it :/ I don't want MPlayer to do any more man page and /bin pollution than it does. (I can especially say I'm very against 'mplayer-slave' being automatically installed with make install - it would ruin tab completion! 'mpl<tab>' gives me 'mplayer ', after which i can immedeatily write the filename... this would make it expand to 'mplayer', without the space, cause it's ambiguous.) Although it's really not in the same format as most XML docs ("story"), It obviously won't fit in mplayer.1, and I really don't like the idea of making it a different man page. So, either keep it as text (its location is mentioned in the man page, right next to the -slave option, how are people missing it, yet still know -slave??), or make it XML.. That's my opinion anyway. - ods15
Hi, On 8/24/05, Oded Shimon <ods15@ods15.dyndns.org> wrote:
On Tue, Aug 23, 2005 at 11:40:13PM +0200, Guillaume POIRIER wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode.
Please tell me what you think.
Well you asked...
I don't really like it :/ I don't want MPlayer to do any more man page
MPlayer todo list states that mplayer.1 should get splitted one day to mplayer.1 and mencoder.1. The more I think about it, the more I think it'd be a Good Thing(TM).
and /bin pollution than it does. (I can especially say I'm very against 'mplayer-slave' being automatically installed with make install - it would ruin tab completion! 'mpl<tab>' gives me 'mplayer ', after which i can immedeatily write the filename... this would make it expand to 'mplayer', without the space, cause it's ambiguous.)
Although it's really not in the same format as most XML docs ("story"), It obviously won't fit in mplayer.1, and I really don't like the idea of making it a different man page. So, either keep it as text (its location is mentioned in the man page, right next to the -slave option, how are people missing it, yet still know -slave??), or make it XML.. That's my opinion anyway.
The idea of using a man page is that: - man page are supposed to a comprehensive list of options - The current layout of slave.txt is close to what a man page looks like - XML is more a "how to do this or that" and supposed to be documenting every aspect of smth, yet if one day it could be the case, that would be neat [or that could also mean that the project will be dead :) ] - I already converted slave.txt to a groff last night! :) /me summons Diego Guillaume -- Live fast, die old, and make very sure everyone knows you were there. -- Alan Cox
On Wed, Aug 24, 2005 at 12:09:01PM +0200, Guillaume POIRIER wrote:
Hi,
On 8/24/05, Oded Shimon <ods15@ods15.dyndns.org> wrote:
On Tue, Aug 23, 2005 at 11:40:13PM +0200, Guillaume POIRIER wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode.
Please tell me what you think.
Well you asked...
I don't really like it :/ I don't want MPlayer to do any more man page
MPlayer todo list states that mplayer.1 should get splitted one day to mplayer.1 and mencoder.1. The more I think about it, the more I think it'd be a Good Thing(TM).
I'm against this. It's slightly helpful for bakas who don't know how to search, and very annoying for people who do know how to search.
/bin pollution than it does. (I can especially say I'm very against 'mplayer-slave' being automatically installed with make install - it would ruin tab completion! 'mpl<tab>' gives me 'mplayer ', after which i can immedeatily write the filename... this would make it expand to 'mplayer', without the space, cause it's ambiguous.)
Although it's really not in the same format as most XML docs ("story"), It obviously won't fit in mplayer.1, and I really don't like the idea of making it a different man page. So, either keep it as text (its location is mentioned in the man page, right next to the -slave option, how are people missing it, yet still know -slave??), or make it XML.. That's my opinion anyway.
The idea of using a man page is that:
- man page are supposed to a comprehensive list of options
-slave commands are not options. They're a protocol for automated control, not something intended for use by end users. Rich
Hi, On 8/24/05, Rich Felker <dalias@aerifal.cx> wrote:
On Wed, Aug 24, 2005 at 12:09:01PM +0200, Guillaume POIRIER wrote:
Hi,
On 8/24/05, Oded Shimon <ods15@ods15.dyndns.org> wrote:
On Tue, Aug 23, 2005 at 11:40:13PM +0200, Guillaume POIRIER wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode.
Please tell me what you think.
Well you asked...
I don't really like it :/ I don't want MPlayer to do any more man page
MPlayer todo list states that mplayer.1 should get splitted one day to mplayer.1 and mencoder.1. The more I think about it, the more I think it'd be a Good Thing(TM).
I'm against this. It's slightly helpful for bakas who don't know how to search, and very annoying for people who do know how to search.
/bin pollution than it does. (I can especially say I'm very against 'mplayer-slave' being automatically installed with make install - it would ruin tab completion! 'mpl<tab>' gives me 'mplayer ', after which i can immedeatily write the filename... this would make it expand to 'mplayer', without the space, cause it's ambiguous.)
Although it's really not in the same format as most XML docs ("story"), It obviously won't fit in mplayer.1, and I really don't like the idea of making it a different man page. So, either keep it as text (its location is mentioned in the man page, right next to the -slave option, how are people missing it, yet still know -slave??), or make it XML.. That's my opinion anyway.
The idea of using a man page is that:
- man page are supposed to a comprehensive list of options
-slave commands are not options. They're a protocol for automated control, not something intended for use by end users.
In any case, considering some questions on the user mailing list the slave mode seems to have been what several people were looking for, but have never heard of. It's not well advertised, and is part of the functions of mplayer that work just fine for people who have the used for it, therefore I guess the documentation of the slave mode should be put elsewhere. Guillaume -- Live fast, die old, and make very sure everyone knows you were there. -- Alan Cox
On Wed, Aug 24, 2005 at 03:30:55PM +0200, Guillaume POIRIER wrote:
In any case, considering some questions on the user mailing list the slave mode seems to have been what several people were looking for, but have never heard of. It's not well advertised, and is part of the functions of mplayer that work just fine for people who have the used for it, therefore I guess the documentation of the slave mode should be put elsewhere.
I'm confused, what do they know and what are they missing?... If they know -slave, they MUST know slave.txt , if they don't know -slave then all this won't help anyhow.. I think the only fix really necessary is mention -slave and slave.txt in the -input entry in the man page, cause they are very relavent there... - ods15
On Wed, Aug 24, 2005 at 12:09:01PM +0200, Guillaume POIRIER wrote:
Hi,
On 8/24/05, Oded Shimon <ods15@ods15.dyndns.org> wrote:
On Tue, Aug 23, 2005 at 11:40:13PM +0200, Guillaume POIRIER wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
If ever that file get committed, we will need to find a name for that file. I propose "mplayer-slave", and propose to add a script called "mplayer-slave" that launches the movie given in parameter in slave mode.
Please tell me what you think.
Well you asked...
I don't really like it :/ I don't want MPlayer to do any more man page
MPlayer todo list states that mplayer.1 should get splitted one day to mplayer.1 and mencoder.1. The more I think about it, the more I think it'd be a Good Thing(TM).
I am against this unless it is done automatically, ie. if all mplayer/mencoder specific options are somehow marked and the corresponding man pages are then generated automatically. Otherwise each patch needs to be applied to both man pages. The biggest part of mplayer.1 is common for both mplayer and mencoder anyway... About the slave.1 man page: I also vote against this man page usually (ok not always, eg. perl) refer to the program beeing used so slave.1 is no option for me. Additionally I don't think that slave.1 is better found than tech/slave.txt. Renaming it to mplayer-slave also is no solution to me. It really isn't that hard to type mplayer -slave, so why create an extra program just for the sake of a man page? So I vote for either including it to the mplayer man page (I have no problems with big man pages, but some ppl do?), leave it as it is or maybe include it into the xml docs. Best Regards Jonas
Hi, On 8/23/05, Guillaume POIRIER <poirierg@gmail.com> wrote:
Hi there,
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
And now the _real_ attachement. Guillaume -- Live fast, die old, and make very sure everyone knows you were there. -- Alan Cox
On Wed, Aug 24, 2005 at 09:12:31PM +0200, Guillaume POIRIER wrote:
On 8/23/05, Guillaume POIRIER <poirierg@gmail.com> wrote:
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
And now the _real_ attachement.
I don't really think this is the way to go. The slave mode is mostly for people that build MPlayer frontends etc. I think this kind of documentation is best done as plaintext. Yes, slave mode (like many other features) could be advertised more... Diego
Hi, On 9/6/05, Diego Biurrun <diego@biurrun.de> wrote:
On Wed, Aug 24, 2005 at 09:12:31PM +0200, Guillaume POIRIER wrote:
On 8/23/05, Guillaume POIRIER <poirierg@gmail.com> wrote:
The slave mode of MPlayer has not been advertised as much as it deserves to. Please find in attachment of "GROFFed" version of the slave mode doc. I checked the formatting, it seems okay on my side.
And now the _real_ attachement.
I don't really think this is the way to go. The slave mode is mostly for people that build MPlayer frontends etc. I think this kind of documentation is best done as plaintext. Yes, slave mode (like many other features) could be advertised more...
I agree too. A nice sub-section on the XML doc should do the trick I guess. Guillaume -- Reading doesn't hurt, really! -- Dominik 'Rathann' Mierzejewski
participants (6)
-
Diego Biurrun -
Dominik 'Rathann' Mierzejewski -
Guillaume POIRIER -
Jonas Jermann -
Oded Shimon -
Rich Felker