Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation about "-l" lock screen option #87

Open
PaulCoral opened this issue Sep 18, 2019 · 8 comments · May be fixed by #164 or #186
Open

Documentation about "-l" lock screen option #87

PaulCoral opened this issue Sep 18, 2019 · 8 comments · May be fixed by #164 or #186
Assignees

Comments

@PaulCoral
Copy link

PaulCoral commented Sep 18, 2019

I am submitting a Feature Request

Lack of description of the "-l" lock option in the man page.
The option is proposed when you type "cmatrix -h" to get help text, but anything in man page.

Request :
Complete the man page (and add the manner to quit this lock screen.)
Or suppress this option that force you to reboot if you don't know how to "unlock"

Tested on GNU/Linux Debian 10 Buster (stable)

thanks

@joaov777
Copy link

joaov777 commented Oct 4, 2019

I had such problem. I couldn't and still haven't figured out a way to "unlock" the matrix screen after "cmatrix -l".

It would be nice if a sort of screen lock was implemented.

@velade
Copy link

velade commented Oct 19, 2020

I haven't figured out a way to "unlock" the matrix screen after "cmatrix -l" too.
BUT
You can do it with a simple code modification,Just find out

case 'L':
    lock = 1;
    break;

in cmatrix.c file.
Then change it to:

case 'L':
    lock = (lock == 0)?1:0;
    break;

Finally, compile and install, just like installing the unmodified version.

After modification, you can switch the lock by entering "L".

@AlexRomberg
Copy link

When you type cmatrix --help it lists all arguments, containing a description for "-L".
-L: Lock mode (can be closed from another terminal)
But like velade I couldn't find anything stoping the lockmode.

To close it, start another console, type ps -a to get a list of running processes, e.g.

PID   TTY          TIME CMD
16769 pts/7    00:00:01 cmatrix

and stop "cmatrix" using the PID kill <PID> e.g. kill 16769

@PaulCoral
Copy link
Author

PaulCoral commented Nov 9, 2020

When you type cmatrix --help it lists all arguments, containing a description for "-L".
-L: Lock mode (can be closed from another terminal)
But like velade I couldn't find anything stoping the lockmode.

To close it, start another console, type ps -a to get a list of running processes, e.g.

PID   TTY          TIME CMD
16769 pts/7    00:00:01 cmatrix

and stop "cmatrix" using the PID kill <PID> e.g. kill 16769

For me killall cmatrix does the thing as well, you do not need to get the PID (be aware that it will terminate all instances of cmatrix)

@space-pagan
Copy link

Documentation is being added. Intended behaviour is that cmatrix -L cannot be terminated from the terminal in which it was run. Use a different terminal or tty to kill it when desired. Generally pkill cmatrix should suffice.

@promitheas17j
Copy link

First timer here. What is the file for the man page? Meaning, what needs to be edited to add the -L description when running "man cmatrix"?

Thanks in advance.

@Platypuschan
Copy link

First timer here. What is the file for the man page? Meaning, what needs to be edited to add the -L description when running "man cmatrix"?

Thanks in advance.

"man cmatrix" is running the program "man" aka 'manual', which is able to show "a man file" of a programm (when the programer has made "a man file" for his program). "a man file" lists how to work with this programm, showing syntax of variables and and options you can use with the programm. your command is showing the "man file" for the program cmatrix.
to run cmatrix itself just use enter "cmatrix" and press enter, with ctrl + c you can end cmatrix again.
Please, github isn´t the place to ask questions how to run programs on linux in the first place, there are plenty of other places where people are keen to help you learning linux, irc-channels for example. Github has a different purpose...

abishekvashok added a commit that referenced this issue Dec 28, 2022
Adds option to unlock terminal put into Cmatrix lock mode by pressing
L thrice.

Updates man page with the minor change as well.

Fixes: #87 and #162
Signed-off-by: Abishek V Ashok <[email protected]>
@abishekvashok
Copy link
Owner

What do ya'll think about #164 ?

@abishekvashok abishekvashok self-assigned this Dec 28, 2022
@concussious concussious linked a pull request Apr 1, 2024 that will close this issue
concussious added a commit to concussious/cmatrix that referenced this issue Apr 5, 2024
- cmatrix.1 > cmatrix.6 (screensavers traditionally filed as games)
- rewrite in mdoc(7)
- write document description for visibility in manual searches
- maintain synopsis, options, and keystrokes
- write vendor neutral description of the program
- add examples including vendor neutral examples
- move homepage to SEE ALSE and link it as well as relevant pages
- add terse HISTORY
- make program usage output consistent with the maintenance above

Fixes: abishekvashok#87 , abishekvashok#105 and abishekvashok#162
concussious added a commit to concussious/cmatrix that referenced this issue Apr 5, 2024
- cmatrix.1 > cmatrix.6 (screensavers traditionally filed as games)
- rewrite in mdoc(7)
- write document description for visibility in manual searches
- maintain synopsis, options, and keystrokes
- write vendor neutral description of the program
- add examples including vendor neutral examples
- move homepage to SEE ALSO, link it, and relevant pages
- add terse HISTORY
- make program usage output consistent with the maintenance above

Fixes: abishekvashok#87, abishekvashok#105, and abishekvashok#162
concussious added a commit to concussious/cmatrix that referenced this issue Apr 5, 2024
- cmatrix.1 > cmatrix.6 (screensavers traditionally filed as games)
- rewrite in mdoc(7)
- write document description for visibility in manual searches
- maintain synopsis, options, and keystrokes (consisency, organization)
	-do this in cmatrix.c logic and usage as well
- write vendor neutral description of the program
- add examples including vendor neutral examples
- move homepage to SEE ALSO, link it, and relevant pages
- add terse HISTORY

Fixes: abishekvashok#87, abishekvashok#105, and abishekvashok#162
concussious added a commit to concussious/cmatrix that referenced this issue Apr 12, 2024
- cmatrix.1 > cmatrix.6 (other screensavers seem filed as games)
- rewrite manual in mdoc(7) according to its best practices
- write document description for visibility in manual searches
- maintain synopsis, options, and keystrokes (consisency, organization, nits)
	-do this in cmatrix.c usage for consistency
		- do this in cmatrix.c logic for maintainability
- write vendor neutral description of the program
- add EXAMPLES including updated readme and vendor neutral examples
- add SEE ALSO, including homepage as well as relevant manual pages
- add HISTORY mentioning original author, date, and vendor
- add CAVEATS mentioning trademarks
- revise BUGS, black doesn't work, and cmatrix no longer has high utilization

Fixes: abishekvashok#87, abishekvashok#105, and abishekvashok#162
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment