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.

Similar Messages

Man pages vs. options found in /usr/includes/sys

I am working with ecpp from the man pages. Mentioned are the various include files. Within the include files are mention of EPP, and DEBUG mode. About those I can find nothing more what-so-ever (except one snippet tantilizer at Sun's "Printing in the Solaris Environment: More Tips and Ideas"). SOMEBODY is using this stuff, why is it hidden from "us"?
My immediate question is, "If its not in the (latest) man pages [7-Dec-2000], am I asking for heartburn by expecting to utilize extra modes found in the include files?"

Yes.

Hyperlinks in Terminal man pages

Several third party applications (eg ManOpen) put hyperlinks in man pages. Often this is done on the fly using the same man page source as the Terminal.
Does Apple do this with the Terminal or any other applications which use local (ie not web) man pages?
My groff_mdoc man page says:
.Lk To be written
but a more informative description at http://www.daemon-systems.org/man/mdoc.7.html says:
.Lk link (for conversion to HTML). Usage: .Lk <href> [anchor-text]
I suspect Lk has not been widely used and that third party applications probably use the existing Xr tags about which my groff_mdoc man page says:
Manual Page Cross References
The '.Xr' macro expects the first argument to be a manual page name. The optional second argument, if a string (defining the manual section), is put into parentheses.
Usage: .Xr ⟨man page name⟩ [⟨section⟩] ...
.Xr mdoc        mdoc
.Xr mdoc ,      mdoc,
.Xr mdoc 7      mdoc(7)
.Xr xinit 1x ;  xinit(1x);
The default width is 10n.
Is it possible to get the Terminal to use these existing Xr tags as hyperlinks?

Sorry, I didn't peruse that link. On my machine, man:<commmand> works in Safari.
Thanks for that I had misread the instructions and tried man: ls and man ls (as per terminal) rather than the correct man:ls
That's incorrect. This example is from the chmod manpage:
+     The -H, -L and -P options are ignored unless the -R option is specified. In addition, these options override each other and the command's+
+     actions are determined by the last one specified.+
In my terminal I get the following:
Case 1 - Terminal/Prefences/Window Columns set to 80
The -H, -L and -P options are ignored unless the -R option is specified.
In addition, these options override each other and the command's actions
are determined by the last one specified.
Case 2 - Terminal/Prefences/Window Columns set to 120
The -H, -L and -P options are ignored unless the -R option is specified. In addition, these options
override each other and the command's actions are determined by the last one specified.
For these tests I closed Preferences and then opened a new Terminal window. Manually widening the windows did not increase text width further but narrowing them resulted in an untidy soft text wrap a character at a time rather than the normal word at a time.
Am I the only one with a Terminal that does this or does it work for others?

How to export all the man page in mac to PDF?

How to export all the man page in mac to PDF?
I have tried "man -t cat | pstopdf -i -o ~/Desktop/cat.pdf" but this only output one page.
How could I dump all the man pages to pdf with one or few command as possible?
The other question is, I copy all the man pages form /usr/share/man, they are .gz.
After I unzip them and open with less, texteidtor, ultraeditor, all the formate are weird.
Is there any tool could open them with the right formate as man does?
I know the man in linux uses the tool "less" to read man pages. How about mac???

I use Bwana. Copy all and paste into TextEdit. Then, save it. This is the beginning for diskutil:
diskutil(8)               BSD System Manager's Manual              diskutil(8)
NAME
     diskutil -- Modify, verify and repair local disks.
SYNOPSIS
     diskutil [quiet] verb [options]
DESCRIPTION
     diskutil manipulates the volume-level structure of local disks. It pro-
     vides information about, and allows the administration of, the partition-
     ing scheme of disks, optical discs, and AppleRAID sets.
VERBS
     Each verb is listed with its description and individual arguments.
     list [-plist | device]
                List disks. If no argument is given, then all disks and all
                of their partitions are listed.
                If -plist is specified, then a property list will be emitted
                instead of the normal user-readable output. If a device is
                specified, then instead of listing all families of whole disks
                and their partitions, only one such family is listed. In that
                case, specifying either the whole disk or any of its slices
                will work. The -plist and device arguments may not both be
                specified at the same time.

Browse man pages in Lion's Terminal

Just read about this, thought it was worth sharing:
Browse man pages in Lion's Terminal

Also key combination:
control-option-command-/
shift-control-command-?

Completion of Man Pages in bash [SOLVED]

Sorry to post such a trivial topic, but the irc channel was unfortunately less than helpful.
I would like to have man pages tab complete, e.g. 'man pac\t' -> 'man pacman'.
I do NOT want bash-completion. It is bloated, unnecessary, and contrary to my notion of the Arch Way. Unfortunately, documentation for the completion mechanism itself is scarce, and usually only shows how to do filetype completion. Google has not helpful, this forum recommends the bash-completion package. I have looked at the package itself to look for the pertinent function or command. Grepping for man, manpage, manual was unsuccessful, and the pertinent command is not readily apparent.
Last edited by egan (2010-02-07 23:13:25)

File completion should be good enough an example as you're replacing the list of files with a list of man pages - which are files in (below) a specific directory. Basically you need to write a function that returns the list of possibilities - which will be a list of man pages in this case.
There's a good example (of the general mechanism) at this page http://www.debian-administration.org/ar … ion_part_2 as well as in books like "Learning The Bash Shell" by O'reilly. The man page also covers it (search for "Programmable Completion").

Man Pages for OS X Tiger

Does anyone know where I can download the man pages ? My iMac went to the "grey screen with endless spinning gear of death" and I want to download my files to an external drive (by firewire) but my Mac will not recognize the external drive as I am in the Install services via Disk 1. I can see my files via terminal and I want to be able to manually set up the external drive to I can transfer then I can wipe out my HD and start over.
Anyone have any suggestions and or know of where I can get the pages ? Thx !!!

OK. Let me make sure I am understanding this correctly:
- you have a problem with the mac such that you cannot boot
- you can boot from the install disk
- you have an external FW drive which you wish to transfer files to before reinstalling
Questions:
- have you used the external drive before or is it new?
- when you say you are "at the utilities menu", do you mean that you've opened Disk Utility and you can see the external drive on the left?
-> if so, select it and then choose the "Erase" tab. Select a format and give the disk a name. It is not a bad idea to choose the "security options" and opt to write zeros (once) to the disk. Then choose "erase". This will erase everything on the disk so only do this if the disk is new or you don't need anything on the disk. If you aren't sure which format to choose from the drop-down menu, "Mac OS Extended (Journaled)" is a good choice unless you need to use the disk with Windows as well. If you chose the writing zeros option, find something to do as it will take a while depending on the size of the disk. Try mounting the new volume now - that is, select the volume on the left (it will have your chosen name) and choose mount from the menu or toolbar.
- how are you thinking of transferring your files? If the drive is suitable, you could install OS X on the external drive, boot from that and retrieve the files from your internal drive that way. Or were you thinking of something else?
Manpages:
- are you using Terminal from the Utilities menu on the install disk? I think you can access the man pages that way. I don't know if you can do so directly, though you can try, but you may be able to access them from hour hard drive by specifying a complete path e.g. man /Volumes/Macintosh\ HD/usr/share/man/man1/kill.1.
Have you tried repairing your internal drive using Disk Utility?
- cfr

What does "restrict" mean in Solaris 10 man pages ?

Hi everyone,
On Solaris 10 programming man pages I see the
"restrict" word used quite often. What is its meaning ?
It wasn't there in previous releases. Is it documented anywhere ?
Excerpt from select(3c) man page:
    int select(int nfds, fd_set *restrict readfds, fd_set *res-
     trict writefds, fd_set *restrict errorfds, struct timeval
     *restrict timeout);Thanks.,
Vlad.

It's for C99. It has to do with pointer aliasing. See section D.1.2.1 of
http://docs.sun.com/source/817-6697/c99.app.html
and section 3.8.2 of
http://docs.sun.com/source/817-6697/parallel.html#70231
- Stephen

Man page or example for ddi_walk_devs

Hallo,
I'm developing a pseudo driver for Solaris 8 on UltraSparc 540 architecture.
I would like walk trough the dev_info tree and store some infos about my machine. I know it is possible to do this at user level with the functions of libdevinfo library but unfortunately it can't work in a driver I've found the prototypes and short comments for a set of functions like ddi_walk_devs, ddi_get_child ... in the file
/usr/include/sys/sunddi.h
There are no documents or man pages about.
Is there anyone who has already used this functions or could help me.
Thank you very much for your help.
al_vise

Hi Al,
ddi_walk_devs(device, function, argument);
The first argument is a device node to start from.If you want to start from the top there is a ddi_root_node function.
ddi_walk_devs then walks the device tree a level at a time, calling a function specified by you as the second arg. This function is passed a pointer to the device node, and your final pointer argument.
However, before calling this, the device tree has to be locked. This used to be done with a reader_writer lock, now there is a new undocumented function to do it (i_ndi_block_device_tree_changes).
The ddi_walk_devs function is deliberately not documented because it is not intended for use in leaf drivers, and its is subject to change (as per the tree locking).
Hope that helps.
Regards,
Ralph
SUN DTS

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.

Matrix exporting to excel with empty columns, with page break option of "Between each instance of a group" selected.

I am working with Report Builder 3.0 I am using a matrix to produce grouped data on separate worksheets in excel.
The select is:
SELECT ID, Measurement, Value, [Date] FROM Measurements_Report. (please ignore the underscores they are just for formatting)
The contents of the Measurements_Report table:
ID__Measurement__Value__[Date]
1___Hot_________33_____10/1/2014
2___Hot_________44_____10/2/2014
3___Cold_________55_____10/2/2014
The matrix contains a single row group based on the field "measurement". The Measurement group has the page break option of "Between each instance of a group" selected.
There is a column group based on the field "Date".
When this is matrix is exported to excel on the first worksheet (Hot) there are three columns as shown below:
ID__10/1/2014____10/2/2014___10/2/1014
1___33
2_______________44
Notice the last column doesn't have a value.
On the second worksheet (Cold) there are also three columns as shown below:
ID__10/1/2014___10/2/2014___10/2/1014
3__________________________55
This time notice there is only one row and only a value in the last column.
I only want the columns with data for that worksheet to show up. How can I remove these empty/duplicate columns? Hopefully there is a simple fix. Thanks ahead of time.

With the following contents of the Measurements_Report table:
ID__Measurement__Value__[Date]
1___Hot_________33______10/1/2014
2___Hot_________43______10/1/2014
2___Hot_________44______10/2/2014
3___Cold________55______10/2/2014
Returns on the first tab (Hot):
ID__10/1/2014____10/1/2014____10/2/2014
1___33
2_________________43
2______________________________44
In the excel worksheet it contains a separate column for each date with a value. Thanks again!
Why is the same date repeating on multiple columns? Do you've the time part also returned from database?
Please Mark This As Answer if it solved your issue
Please Mark This As Helpful if it helps to solve your issue
Visakh
My MSDN Page
My Personal Blog
My Facebook Page

No scrolling when viewing man pages with Gnome terminal?

Hi all,
I have just installed Oracle Solaris 11 on x86. For a long time I've used Solaris 9 on SPARC. I like the new OS, but I'm having a problem viewing man pages with Gnome terminal. When I view a long man page, e.g., "man newfs", I don't get a functional scroll bar on the right hand side of the window. And although the space bar works to advance the page, when I reach the end, it doesn't return to the command prompt. It just beeps, prints "END", and I can only exit by closing the window. Can anyone tell me how to fix this? Suggestions would be much appreciated.
Many thanks,
Chris Tidy

It does sound like you're using "less" instead of more. When you see the "(END)" prompt you can simply type "q" and it will exit back to the command line prompt making it unnecessary to close the window. See the "less" manual page for more detail on the less command. Under Solaris 9 the paging was done with the "more" command. If you set the PAGER environment variiable to "more" the man page will use more and revert to the behavior you'd be used to with Solaris 9. Less erases the text you've already read when you type that final "q" which is a behavior I don't like. I didn't bother to determine if there is a way to fix that with less, I just went back to more. The choice between "more" and "less" is a personal preference.

Is it possible to Default "Choose page source by PDF page size" option in the "Print" dialog box?

I have an SSRS report that is rendered as a PDF file; the report has many columns and utilizes 11inx17in (Landscape) paper. However, once the report is rendered and users try to print the report they have to manually select the 'Choose Paper source by PDF page size' option in order to get the report to print on the correct paper (otherwise it defaults to standard letter size - landscape orientation).
I'm aware of 'Print Presets' functionality; however, I don't believe they apply to this scenario. Is there a config file/registry setting/anything that can be specified to automatically set the 'Choose paper source by PDF page size' print setting = On/True/Checked?
Any help would be greatly appreciated...

Anybody out there?

Can we update the man pages for "dynamic_pager"?

The configuration file is listed as, /Library/Preferences/com.apple.virtualMemory.plist but from what I understand, it is located in /System/Library/LaunchDaemons/com.apple.dynamic_pager.plist.

Send Apple feedback about it, and they will likely update the man page: http://www.apple.com/feedback/macosx.html
Alternatively you can edit the man page file for the dynamic_pager itself. It is located here: /usr/share/man/man8/dynamic_pager.8

Page Setup options cached somewhere?

I'm trying to help someone in my office who can no longer select "Tabloid" size paper in the Page Setup. We have a Xerox Splash G640 which gives me about fifteen different page sizes in the Page Setup window, but even after deleting her printer from the Printer Setup Utility and re-adding it, she only gets Letter and Legal size. When I started helping her, the Printer Setup Utility said the printer was using the generic postscript driver and I manually changed it to the correct driver. This did not fix the issue, so we deleted and re-added the printer. But, the incorrect page sizes are still in the Page Setup window. If you select another printer from the list in Page Setup and choose Tabloid size paper, the printer prints a Tabloid size image, but on a Letter size piece of paper... She's got Mac OS X 10.4.3 (we're giving everyone updates to 10.4.5 later this week) and although this issue is occurring in any application, we need to print from PhotoShop CS2.
It appears to me that Mac OS X is "caching" this information somewhere, but I'm not sure where. Is there a folder or file I could delete to try to clear this up?
-Doug

Thank you for your reply. I've already replaced the PPD with the one from my computer which does show all the page sizes correctly (on my computer). It appears to be an issue deeper than simply selecting the correct PPD file in the Printer Setup Utility. Somehow, the options in the Page Setup are "stuck" and will not change even if you change the PPD file associated with that printer. You see the same page size options (the incorrect ones) whether that printer is set-up with the "generic" PostScript driver, the correct Mac OS X printer driver or manually selecting the Mac OS 9 printer driver from the Classic System Folder/Extensions/Printer Drivers. No matter which PPD we choose, the wrong page sizes persist in the Page Setup dialog.
-Doug

Man pages & documentation, optional?

Similar Messages

Maybe you are looking for