Man pages in the wiki?

Hi all,
I think it would be handy to add man pages in the wiki so that an article could refer to it if need be. So the questions are:
1) Has this been discussed before?
2) What do you think of the idea?
Cheers,
X

chimeric wrote:
There's a even "nicer" resource for man pages than google, namely http://www.man.cx. Just append the program you want to read the man page for after the '/'. For example:
http://man.cx/ls
Maybe one of the wiki admins could add an interwikilink (eg. [[man>ls]]) if that's possible in mediawiki (not sure atm).
Wow! That's cool, I have also noticed that you can actually add your own comments to the man pages, that's very useful.

Similar Messages

Beginners guide screwed|Is impossible to edit large pages on the wiki

When you're trying to edit a large page on the wiki you get this message:
WARNING: This page is 40 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections.
Firefox can handle the 40kb but not the 107kb of the Begginers Guide for example.
And when you do a change, if you dont preview it you get a shiny blank page instead of the document.
I was trying to add one line to the Oficcial installation guide and ended up breaking it into two parts (i move the apendix to another page) to be able to recover it's contents.
Some other person form #archlinux that was helping me with this issue also accidentally override the text from the Beginners guide, and we can't roll back it. So, any WikiAdmin can roll back the changes on the Beginners guide? and tell us (the normal users) how to edit long pages.
Thanks
Last edited by __void__ (2009-01-21 16:34:47)

__void__ wrote:
When you're trying to edit a large page on the wiki you get this message:
WARNING: This page is 40 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections.
Firefox can handle the 40kb but not the 107kb of the Begginers Guide for example.
And when you do a change, if you dont preview it you get a shiny blank page instead of the document.
I was trying to add one line to the Oficcial installation guide and ended up breaking it into two parts (i move the apendix to another page) to be able to recover it's contents.
Some other person form #archlinux that was helping me with this issue also accidentally override the text from the Beginners guide, and we can't roll back it. So, any WikiAdmin can roll back the changes on the Beginners guide? and tell us (the normal users) how to edit long pages.
Thanks
Some other person here, sorry about that accidental Beginner's guide trash up
Mr.Elendig wrote:For future reference, don't edit the whole page at once, just edit a section of it. When you are logged in, every section have a 'edit' button/link.
Got it!
Last edited by zaggynl (2009-01-22 09:35:03)

Can I create a Desktop page on the wiki ?

Hi there,
I was using Arch since 1 or 2 weeks now, and I am still in the 'tune the system to get a working desktop' phase.
On the way, I took extensive notes about everything I installed and set-up.
So I was thinking about creating a wiki page (that could be named something like : "Desktop Arch : Zero2Heaven") that list every step to get a working desktop configuration.
The idea is to provide a guide to set up a workstation easily for a non-guru arch new user like me.
Before doing anything, I just wanted to be sure creating this kind of page isn't against some wiki protocol (I don't think so but better safe than sorry ).
See you around
Tereva

karol wrote:
axel668 wrote:Which desktop ? There is no such thing as THE desktop in Arch or even in Linux in general, so the only useful content of a desktop page might be a couple of links to other Wiki pages, maybe about Xorg and the most popular DEs (Gnome, KDE, XFCE, LXDE, Openbox, Enlightenment, ...)
That's why OP's personal preferences should go to his user page and not as a regular article.
I've seen wiki user pages that listed some configs that their authors found useful, nothing wrong with that.
I think there is something missing in the documentation / wiki : How to mount 'quickly' a usable desktop configuration.
The idea was to hook false beginner / 'young' intermediate Linux user, that want to give Arch a try, but don't have the knowledge/experience to sort all the info available in the wiki to install a desktop config.
IMO this could help expand the user base.
Tereva
PS : I was going for LXDE + java + audio/video codex + usb auto-mounting + some fonts...
Of course I don't pretend this is THE ultimate desktop experience (everyone has his own preferences).
But at least by following the guide I was thinking about, someone can have a -fast- usable desktop in 10 / 15 min.

Makepkg: How to include source-bundled 'man pages' in the package?

I'm trying to create a PKGBUILD for my own Python program.
The source code has been packaged using Python's distutils. Now, AFAICT distutils do not help you in any intelligent way to include a man page, so I just used a MANIFEST template to add the file to the source package.
As for the PKGBUILD, I'm currently using an 'install -D -m0644' command (in the 'package' function) to copy the page from a directory under $srcdir to "${pkgdir}/usr/share/man/man1/${pkgname}.1.gz".
However, seeing that makepkg has some built-in functions for compressing man pages, I figured that maybe it could deal with the proper placement too? My manual approach works nicely, but well, I figure the less of a hack job, the better.
Thanks in advance - this is my first program and package build so I wanna get it right :)

Thanks joyfulgirl - I guess I hadn't really thought through what kind of a deal makepkg is.
At any rate, I figured I wouldn't have been the only Pythonista dealing with this issue and starting reading other people's setup scripts and according to Mutagen's setup.py putting desktop software man pages in 'share/man/man1' under the 'installation prefix' (a local variable, usually '/usr' or '/usr/local') can be considered a POSIX universal. Don''t know if this is reliable or just one hack replacing another, but it would mean being able to let Python's setup script take care of pretty much everything.

How do you get the Calendar in My Page on the Wiki to show up on Group Calendar in Wiki

I"m using Snow Leopard Server 10.6.8, and it permits you to setup a personal web calendar and a group calendar on its WIKI. Since I'm a member of the group, why can't the calendar events I enter in My Page show up on the Group Calendar WIKI page?

Greetings Stephen,
You may wish to ask this question in the server forum as Calendar Wikis are a function of server, not of the iCal.app: https://discussions.apple.com/community/servers_enterprise_software/mac_os_x_ser ver_v10.6_snow_leopard
Cheers.

Thr_create() returns -1 which isn't specified in the man page. What is -1?

Hello,
I'm for the first time experimenting with Solaris threads as I'm porting an AIX app. over to Solaris.
Anyhow, I have a sample program that creates a simple thread. For some reason, the return value of of the initial thr_create is -1, which isn't specified in the man page for thr_create. The man page lists the following return values, non of which are -1:
RETURN VALUES
Zero indicates a successful return and a non-zero value
indicates an error.
ERRORS
If any of the following conditions occur, these functions
fail and return the corresponding value:
EAGAIN The system-imposed limit on the total number
of threads in a process has been exceeded or
some system resource has been exceeded (for
example, too many LWPs were created).
EINVAL The value specified by attr is invalid.
If any of the following conditions are detected,
pthread_create() fails and returns the corresponding value:
ENOMEM Not enough memory was available to create the
new thread.
If any of the following conditions are detected,
thr_create() fails and returns the corresponding value:
EINVAL o stack_base is not NULL and stack_size is
less than the value returned by
thr_min_stack(3T).
o stack_base is NULL and stack_size is not
zero and is less than the value returned by
thr_min_stack(3T).
However, I don't see a -1 there and therefore, don't know what this means.
Here is the simple code that I wrote for this experiment as well as the output. It doesn't get too far into the program before exiting - I've bolded where it exits:
#define _REENTRANT
#include <stdio.h>
#include <thread.h>
#include <errno.h>
/* Function prototypes for thread routines */
void sub_a(void );
void sub_b(void );
void sub_c(void );
void sub_d(void );
void sub_e(void );
void sub_f(void );
thread_t thr_a, thr_b, thr_c;
void main()
thread_t main_thr;
int rc = 0;
main_thr = thr_self();
printf("Main thread = %d\n", main_thr);
if (rc = thr_create(NULL, 0, sub_b, NULL, THR_NEW_LWP, &thr_b))
printf("\n rc = %d",rc);
switch(rc)
case EAGAIN: printf("This one1");
break;
case EINVAL: printf("This one2");
break;
case ENOMEM: printf("This one3");
break;
default: printf("rc = %d");
break;
fprintf(stderr,"Can't create thr_b\n"),
* exit(1); *
/* if (thr_create(NULL, 0, sub_a, (void *)thr_b, THR_NEW_LWP, &thr_a))
fprintf(stderr,"Can't create thr_a\n"), exit(1); */
if (thr_create(NULL, 0, sub_c, (void *)main_thr, THR_NEW_LWP, &thr_c))
fprintf(stderr,"Can't create thr_c\n"), exit(1);
printf("Main Created threads A:%d B:%d C:%d\n", thr_a, thr_b, thr_c);
printf("Main Thread exiting...\n");
thr_exit((void *)main_thr);
void sub_a(void arg)
thread_t thr_b = (thread_t) arg;
thread_t thr_d;
int i;
printf("A: In thread A...\n");
if (thr_create(NULL, 0, sub_d, (void *)thr_b, THR_NEW_LWP, &thr_d))
fprintf(stderr, "Can't create thr_d\n"), exit(1);
printf("A: Created thread D:%d\n", thr_d);
/* process
for (i=0;i<1000000*(int)thr_self();i++);
printf("A: Thread exiting...\n");
thr_exit((void *)77);
void * sub_b(void *arg)
int i;
printf("B: In thread B...\n");
/* process
for (i=0;i<1000000*(int)thr_self();i++);
printf("B: Thread exiting...\n");
thr_exit((void *)66);
void * sub_c(void *arg)
void *status;
int i;
thread_t main_thr, ret_thr;
main_thr = (thread_t)arg;
printf("C: In thread C...\n");
if (thr_create(NULL, 0, sub_f, (void *)0, THR_BOUND|THR_DAEMON, NULL))
fprintf(stderr, "Can't create thr_f\n"), exit(1);
printf("C: Join main thread\n");
if (thr_join(main_thr,(thread_t *)&ret_thr, &status))
fprintf(stderr, "thr_join Error\n"), exit(1);
printf("C: Main thread (%d) returned thread (%d) w/status %d\n", main_thr, ret_thr, (int) status);
/* process
for (i=0;i<1000000*(int)thr_self();i++);
printf("C: Thread exiting...\n");
thr_exit((void *)88);
void * sub_d(void *arg)
thread_t thr_b = (thread_t) arg;
int i;
thread_t thr_e, ret_thr;
void *status;
printf("D: In thread D...\n");
if (thr_create(NULL, 0, sub_e, NULL, THR_NEW_LWP, &thr_e))
fprintf(stderr,"Can't create thr_e\n"), exit(1);
printf("D: Created thread E:%d\n", thr_e);
printf("D: Continue B thread = %d\n", thr_b);
thr_continue(thr_b);
printf("D: Join E thread\n");
if(thr_join(thr_e,(thread_t *)&ret_thr, &status))
fprintf(stderr,"thr_join Error\n"), exit(1);
printf("D: E thread (%d) returned thread (%d) w/status %d\n", thr_e,
ret_thr, (int) status);
/* process
for (i=0;i<1000000*(int)thr_self();i++);
printf("D: Thread exiting...\n");
thr_exit((void *)55);
void * sub_e(void *arg)
int i;
thread_t ret_thr;
void *status;
printf("E: In thread E...\n");
printf("E: Join A thread\n");
if(thr_join(thr_a,(thread_t *)&ret_thr, &status))
fprintf(stderr,"thr_join Error\n"), exit(1);
printf("E: A thread (%d) returned thread (%d) w/status %d\n", ret_thr, ret_thr, (int) status);
printf("E: Join B thread\n");
if(thr_join(thr_b,(thread_t *)&ret_thr, &status))
fprintf(stderr,"thr_join Error\n"), exit(1);
printf("E: B thread (%d) returned thread (%d) w/status %d\n", thr_b, ret_thr, (int) status);
printf("E: Join C thread\n");
if(thr_join(thr_c,(thread_t *)&ret_thr, &status))
fprintf(stderr,"thr_join Error\n"), exit(1);
printf("E: C thread (%d) returned thread (%d) w/status %d\n", thr_c, ret_thr, (int) status);
for (i=0;i<1000000*(int)thr_self();i++);
printf("E: Thread exiting...\n");
thr_exit((void *)44);
void sub_f(void arg)
int i;
printf("F: In thread F...\n");
while (1) {
for (i=0;i<10000000;i++);
printf("F: Thread F is still running...\n");
OUTPUT:
# /emc/smithr15/solthread
Main thread = 1
rc = -1Can't create thr_b
rc = -1#
Any ideas as to what -1 indicates and how to solve this?
Thanks for your response,
dedham_ma_man

ok, my bad. I wasn't linking in the -lthread library.
Thanks anyway.

Man pages & documentation, optional?

Hello,
I'm using localepurge every after update/installation and megabytes trown out are countless (with all respect for all other languages). Isn't waste?
Furthermore Lot of html docs are laying around and I merely read one of them. Nearly 100 Mb.
Now-a-day the internet is at the finger tips, what reason enforce to have documentation enclosed with the packages?
We may just read them online. See this site
I'd consider only the core man pages for the time one has to setup a new installation. Perhaps because some information is needed in a particular case. However it could have to consider some other mean to go online during that problem.
Mostly the crowd leaning to have clouds and other stuffs off-box, generally is moving to a global storage, what for moving these bytes?

I also keen man pages with included examples, they bring something to try and modify in a what-if try context.
I don't deny the documentation usefulness, I appreciate Wikis, manuals, and all efforts to let other know/learn about open source.
In the other hand, I see a great increase on travelling bit when a huge portion is, practically, not even taken a look. Beside this I would also consider the volume caused to repeatedly download the same document for several times . Which is a personal option. I mean that I probably read many times these documents.
I like computer because I like to make some programming, then I frequently consult some doc, to learn something more. This usually goes by browser and looking for somebody made similar example.
The concern for this thread is just to have a slim installation on the first place and who likes to have all wirstle&bells will go on for all of them.
Imagine KDE or libreoffice that packing up all the languages, who will want afford it?
Even Mr Judd, I believe, was for this diet. Therefore we have a makepkg.conf with all strip options in there.

[Solved] Looking for arch's original man page color codes

Hey everyone. I'm new to arch, and enjoying having everything begin to work out for me. One thing I was wondering though is what the color codes are that the man pages use before X is loaded or anything similar.
Per the archwiki, I'm using the following to provide myself with colored man pages in urxvt:
From .Xresources:
! colored man pages on rxvt-unicode-256color
URxvt.colorIT: #87af5f
URxvt.colorBD: #d7d7d7
URxvt.colorUL: #87afd7
This works, but it's not the same colorscheme as what arch starts out with initially. Anyone know what that colorscheme is? Or where I could look to find it?
Last edited by zematis (2014-05-12 22:21:30)

ayekat, thanks for the warm welcome!
ayekat wrote:What article in the wiki?
Here's the section in the Wiki I was referring to:
https://wiki.archlinux.org/index.php/ma … vt-unicode
karol wrote:Are you talking about using man pages before installing Arch or after installing but in the tty? Do you want to get the same colors in X?
(I think) I was talking about the colors that the man pages are in the TTY. Specifically, my processes is:
Boot up arch
Login (X yet not started)
Look at a man page - like the colors
Startx - boot to window manager (i3)
Look at a man page - want to change the colors
That said, I liked the colors the man pages had before installing Arch quite a bit, and wouldn't object to learning what those are.
ayekat wrote:Here you are changing how urxvt displays characters that are marked as underline, italic or bold; in particular you are changing their colours.
The thing is, it won't only affect man pages viewed in urxvt, but everything.
Makes sense
ayekat wrote:As for changing the colour scheme of the manpage, you'll probably want to do it more properly, using the LESS_TERMCAP environment variables.
I tried copying your format to my .bashrc and it worked great! So that's a win. Now I just need to figure out what the '\e[#;#;#m' numbers mean. I think I can probably handle that one on my own though. I found a resource here at:
http://misc.flogisoft.com/bash/tip_colo … ng#colors2
And it looks like it covers what I need to know.
Thanks for your help!
And honestly, at this point I think I can figure out what colorscheme I like given the info at hand. So I think we can call this one taken care of.
If it interests anyone, I found a .sh script at the above link to display all 256 colors, then modified it to show the colors bolded, italicized etc. Here's the script:
#!/bin/bash
# This program is free software. It comes without any warranty, to
# the extent permitted by applicable law. You can redistribute it
# and/or modify it under the terms of the Do What The Fuck You Want
# To Public License, Version 2, as published by Sam Hocevar. See
# http://sam.zoy.org/wtfpl/COPYING for more details.
for coltype in {0..8} ; do # Bold, Italic etc.
for fgbg in 38 48 ; do #Foreground/Background
for color in {0..256} ; do #Colors
#Display the color
echo -en "\e[(0${coltype});(${fgbg};5;${color}m ${color}\t\e[0m"
#Display 10 colors per lines
if [ $((($color + 1) % 10)) == 0 ] ; then
echo #New line
fi
done
echo #New line
echo #New line
done
echo #New line
done
exit 0

Can you set a time range in the wiki calendar?

I think the wiki calendar is a great feature in 10.5 Server, however I am annoyed by one problem. I can't figure out a way to limit the time on a wiki to say 8am to 5pm. I would like to use this as a class calendar page on the wiki, but it is really annoying to have to scroll through 24 hour days. Does anyone know a way to do this? It would be great if Apple allows us to edit the time being shown on the wiki.
Thanks,
David

Hi,
I don't have Leopard here to try it with the wiki, but with Tiger I can publish a user calender to the iCal server after setting the time period in iCal client preferences. The times out of range are greyed out. When I subscribe with a different Tiger client those same periods remain greyed out.
Since Tiger can only read calendars I can't test the wiki interaction yet. This tells me that the iCal server can respect time periods once set.
Another data point.
Harry

Bug with Solaris man page on dlsym

I hope someone at Sun working on Solaris is reading this. There are bugs in the Solaris 10 man page on dlsym - there are a couple of places that says "see the .". Apparently soemthing is missing. My version of man pages is "Last change: 26 Sep 2005".

The prototype of pthread_create() is correct on Solaris 10 man page (SunOS 5.10 Last change: 23 Mar 2005):
int pthread_create(pthread_t *restrict thread, const
pthread_attr_t *restrict attr, void
*(*start_routine)(void*), void *restrict arg);
But the prototype of pthread_cleanup_push() is correct on Solaris 10 man page (SunOS 5.10 Last change: 4 Oct 2005) is incorrect:
void pthread_cleanup_push(void (*handler, void *),void *arg);
I guess Sun simply has to check all the man pages of the pthread functions carefully one by one to make sure this error is fixed.

How to install package's man page

Hi all!
I'm the maintainer of pcsx2-svn in AUR and currently the installation process doesn't install the man page automatically. In the source code I have a "pcsx2.man" file, that I'm gzipping and moving to the correct man folder. See command:
gzip -9 "${pkgdir}/opt/pcsx2/docs/pcsx2.man"
mv "${pkgdir}/opt/pcsx2/docs/pcsx2.man.gz" "${pkgdir}/usr/share/man/man1/pcsx2.1.gz"
Is there a more proper way to do this in Archlinux?
Thanks in advance!
p.s.: `make install` will not install the man page, only the translation files.

Ah, simple as that? I didn't how this works until now... Thanks, falconindy!
Last edited by josephg (2011-03-21 03:01:59)

ArchSBS on the wiki

I accidentally discovered these pages on the wiki, and they seem to be complete guides how to set up a Small Business Server using Arch. Unfortunately they are in Italian I think.
I hope to see a translation to English, because I'm very interested in learning more about setting up a server like this (OpenLDAP and Kerberos in combination with files, mail, calendar etc.)
Zl.

I used Google translation tools to translate it to English. There were a few mis translations but it was definitely useful.
http://translate.google.com/translate?u … n&ie=UTF-8
Thanks

Correct location of man pages?

Hi, I'm still pretty new at the command line. I installed growlnotify to play around with it, but the install script puts the man page in the wrong place (/usr/local/man/man1). I found a post that said it should be moved to /usr/local/share/man/man1, but that directory doesn't exist.
Where is the correct place to move it?
And the command should look like this, right?:
$ mv /usr/local/man/man1/growlnotify.1 CORRECT-DIRECTORY
Thanks for any help.
Message was edited by: aaronfalls

Both locations are both correct. /usr/local is the traditional location for may software packages get installed. But platform A may like /usr/local/man and platform B may like /usr/local/share/man. The Growl developer may have started life on a platform that used /usr/local/man and used that because it what they always use.
Just add the path to the MANPATH environment variable.
NOTE: fink.com puts their man pages in /sw/man. MacPorts.org uses both /opt/local/man and /opt/local/share/man, most likely based on what the OpenSource author choose, and not something MacPorts choose.
My current MANPATH contains the following man page locations:
/sw/share/man
/usr/share/man
/usr/local/share/man
/usr/X11/man
/sw/lib/perl5/5.8.8/man
/usr/X11R6/man
/sw/lib/perl5-core/5.8.6/man
/sw/lib/perl5/5.8.6/man
/opt/local/man
/usr/local/man
/opt/local/share/man

Clean of wiki page of Xorg [Wiki]

Just to be clear, I have almost zero knowledge of Xorg and etc.
With the upcoming release of Xorg 1.8, I think a clean and clearer page on the Wiki would be a must for the future. Now the page contain stuff from several years and several versions of Xorg back. With 1.8 and the removal of HAL, a lot of the stuff renders useless (not sure, but I guess so).
The use of udev, u that and u that, things are starting to get more automated. And we can start to look past HAL.
As an example, I just installed Xorg 1.8 on an old Intel integrated chip and it worked flawless except my keymap. Looking behind this, I can only imagine that there will not be so many problems when all the drivers get updated to support 1.8 and things start to work without any user intervention.
Something I would care to see, is a more explanatory page towards 1.8 only and the things the user could be struggling with 1.8, like keymaps, touchpads, etc. Follow the KISS-idea of Arch Linux.
What is your ideas on the matter? Would try to contribute what I can, but not sure what.
(My apologize if my post is hard to understand.)

Haha funny this thread came about!
pyther@arch-general wrote:
Alright! I've attempted to clean up the wiki and update it to reflect changes in 1.8. There was a lot of outdated information in the troubleshooting section so I removed it. I worked with a few people in #archlinux @ freenode to determine what could be removed. I have made a lot of changes so if someone can go over the wiki to look for grammar and clarity errors that would be great.
From what I can tell a lot of the configuration is similar between 1.6 and 1.8 besides the use of InputClasses. The fedora wiki states 'users are discouraged of putting X.org-specific configuration into udev rules files'
Once xorg 1.8 gets merged into extra we will be able to clean up the wiki even more.
So please go through it, see if it makes sense, fix up any grammar or clarity errors!

Man pages for "expr" command incorrect

There appears to be a loss of functionality from the HP-UX environment to the SOLARIS OS that is not noted in the man pages. The man pages for Solaris 5.8 insist that the command expr allows for the argument "substr" as well as "length". However this functionality is not available though the expr command.
Many of our in-house scripts use logic such as
expr substr $VAR 3 2
or
expr length $VAR
Which was valid in the HPUX 10.20 environment. However this command in the Solaris environment results in "expr: syntax error" errors. According to the MAN pages the errors we are having are not happening.

Actually, the man page says that "length" and "substr" are supported only on Solaris x86 and only for compatibility with INTERACTIVE UNIX.
You could use a little script like this one to replace "expr substr" and "expr length" (perl considers the substr's "offset" to be zero-based -- subtract one from $ARGV[2] if HPUX does not).
#!/usr/bin/perl
if ($ARGV[0] eq "substr") {
$out = substr($ARGV[1], $ARGV[2], $ARGV[3]);
elsif ($ARGV[0] eq "length") {
$out = length($ARGV[1]);
else {
print "usage: perl-expr substr string offset length\n";
print " or perl-expr length string\n";
exit 1;
print "$out\n";
exit 0;

Man pages in the wiki?

Similar Messages

Maybe you are looking for