Added Pleng's option to not quit on app run; added toggle (press "A" or tab) for...
[pandora-libraries.git] / minimenu / mmconf.c
1
2 #include <stdio.h>
3 #include <limits.h> /* for PATH_MAX */
4 #define __USE_GNU /* for strndup */
5 #include <string.h> /* for strdup */
6
7 #include "SDL.h"
8 #include "SDL_image.h"
9 #include "SDL_ttf.h"
10
11 #include "pnd_container.h"
12 #include "pnd_conf.h"
13 #include "pnd_discovery.h"
14
15 #include "mmenu.h"
16 #include "mmconf.h"
17 #include "mmcat.h"
18 #include "mmui.h"
19 #include "mmwrapcmd.h"
20
21 static unsigned char conf_render_text ( TTF_Font *f, char *buffer, SDL_Rect *dest, unsigned int x, unsigned int y, unsigned char selected );
22 static unsigned char conf_render_line ( SDL_Rect *dest, unsigned int y );
23 static char *conf_format_int ( int v, change_type_e c );
24
25 confitem_t page_general[] = {
26   { "Default tab to show",           "On startup, Minimenu will try to switch to this tab",     NULL /* default */, "categories.default_cat",  ct_visible_tab_list },
27 #if 0 // and also in mmenu.c -- something crashes during image caching
28   { "Set CPU speed within Minimenu", "Whether the next setting is applied or not",              "0",                "minimenu.use_mm_speed",   ct_boolean },
29   { "CPU speed within Minimenu",     "Set low; speed to run Minimenu at",                       "400",              "minimenu.mm_speed",       ct_cpu_speed },
30 #endif
31   { "Set CPU speed when leaving",    "Whether the next setting is applied or not",              "0",                "minimenu.use_run_speed",  ct_boolean },
32   { "CPU speed when leaving",        "Before running app, set this speed; app may override.",   "500",              "minimenu.run_speed",      ct_cpu_speed },
33   { "Show 'All' tab",                "Whethor an All tab is shown or not",                      "1",                "categories.do_all_cat",   ct_boolean },
34   { "Start with app selected",       "Whethor selection is placed by default or not",           "0",                "minimenu.start_selected", ct_boolean },
35   { "Wrap tab change",               "Changing tab left or right, does it wrap around?",        "0",                "tabs.wraparound",         ct_boolean },
36   { "Grid stop vertical",            "Changing selection up or down, does it stop or wrap?",    "0",                "grid.wrap_vert_stop",     ct_boolean },
37   { "Detail panel on start?",        "Show or hide the detail panel when menu starts",          "1",                "display.show_detail_pane", ct_boolean },
38   { "Live (not exit) on app run?",   "Normally menu exits (to save ram) on app run",            "0",                "minimenu.live_on_run",    ct_boolean },
39   { "Force wallpaper with..",        "You can force an override over themes background",        "/pandora/appdata/mmenu/wallpaper.png", "minimenu.force_wallpaper",  ct_filename },
40   { "",                              "",                                                        NULL,               NULL,                      ct_nil },
41   { "^- Back up to main",            "Go back to top level of configuration",                   NULL,               NULL,                      ct_switch_page, NULL },
42   { NULL }
43 };
44
45 confitem_t page_appshowhide [ CONF_MAX_LISTLENGTH ] = {
46   { "^- Back up to main",        "Go back to top level of configuration",                   NULL,               NULL,                      ct_switch_page, NULL },
47   { CONF_APPLIST_TAG,            "Show or hide this application",                           "1",                "appshow",                 ct_nil },
48   { NULL }
49 };
50
51 confitem_t page_tabshowhide [ CONF_MAX_LISTLENGTH ] = {
52   { "^- Back up to main",        "Go back to top level of configuration",                   NULL,               NULL,                      ct_switch_page, NULL },
53   { CONF_TABLIST_TAG,            "Show or hide or reorder this tab",                        "1",                "tabshow",                 ct_nil },
54   { NULL }
55 };
56
57 confitem_t pages[] = {
58   { "General Options",           "Miscellaneous handy options",                             NULL /* default */, NULL,                      ct_switch_page, page_general },
59   { "Show/Hide Applications",    "Each application can be hidden/revealed",                 NULL /* default */, NULL,                      ct_switch_page, page_appshowhide },
60   { "Show/Hide/Order Tabs",      "Each tab can be hidden/revealed or re-ordered",           NULL /* default */, NULL,                      ct_switch_page, page_tabshowhide },
61   { "",                          "",                                                        NULL,               NULL,                      ct_nil },
62   { "Exit configuration",        "Quit and save configuration",                             NULL /* default */, NULL,                      ct_exit },
63   { "",                          "",                                                        NULL,               NULL,                      ct_nil },
64   { "Reset to defaults",         "Remove any custom options set in this UI",                NULL /* default */, NULL,                      ct_reset },
65   { NULL }
66 };
67
68 extern pnd_conf_handle g_conf;
69 extern SDL_Surface *sdl_realscreen;
70 extern mm_imgcache_t g_imagecache [ IMG_TRUEMAX ];
71 extern mm_category_t *g_categories;
72 extern unsigned char g_categorycount;
73 extern mm_category_t _categories_invis [ MAX_CATS ];
74 extern unsigned char _categories_inviscount;
75 extern pnd_box_handle g_active_apps;
76
77 unsigned char conf_run_menu ( confitem_t *toplevel ) {
78   confitem_t *page = toplevel;
79   unsigned int sel = 0;
80   unsigned int first_visible = 0;
81   unsigned char max_visible = 12;
82   SDL_Event event;
83   confitem_t *lastpage = NULL;
84
85   while ( 1 ) {
86
87     if ( ! page ) {
88       page = pages;
89       sel = 0;
90       first_visible = 0;
91     }
92
93     if ( lastpage != page ) {
94       conf_prepare_page ( page );
95       lastpage = page;
96     }
97
98     conf_display_page ( page, sel, first_visible, max_visible );
99
100     // check for input
101     while ( SDL_WaitEvent ( &event ) ) {
102
103       switch ( event.type ) {
104
105       //case SDL_KEYUP:
106       case SDL_KEYDOWN:
107
108         if ( event.key.keysym.sym == SDLK_UP ) {
109
110           do {
111
112             if ( sel ) {
113               sel--;
114
115               if ( sel < first_visible ) {
116                 first_visible--;
117               }
118
119             }
120
121           } while ( page [ sel ].type == ct_nil );
122
123         } else if ( event.key.keysym.sym == SDLK_DOWN ) {
124
125           do {
126
127             if ( page [ sel + 1 ].text ) {
128               sel++;
129
130               // ensure visibility
131               if ( sel >= first_visible + max_visible ) {
132                 first_visible++;
133               }
134
135             }
136
137           } while ( page [ sel ].type == ct_nil );
138
139         } else if ( event.key.keysym.sym == SDLK_PAGEUP ) {
140           page = NULL;
141
142         } else if ( event.key.keysym.sym == SDLK_LEFT || event.key.keysym.sym == SDLK_RIGHT ) {
143
144           unsigned char left = 0;
145           if ( event.key.keysym.sym == SDLK_LEFT ) {
146             left = 1;
147           }
148
149           switch ( page [ sel ].type ) {
150
151           case ct_cpu_speed:
152             {
153               int v = pnd_conf_get_as_int ( g_conf, page [ sel ].key );
154               if ( v == PND_CONF_BADNUM ) {
155                 v = 500;
156               }
157
158               if ( left ) {
159                 if ( v > 30 ) {
160                   v -= 10;
161                 }
162               } else {
163                 v += 10;
164               }
165
166               char buffer [ 20 ];
167               sprintf ( buffer, "%u", v );
168               pnd_conf_set_char ( g_conf, page [ sel ].key, buffer );
169
170             }
171             break;
172
173           case ct_visible_tab_list:
174             {
175               if ( g_categorycount ) {
176                 char *v = pnd_conf_get_as_char ( g_conf, page [ sel ].key );
177                 if ( v ) {
178                   unsigned char n = 0;
179                   for ( n = 0; n < g_categorycount; n++ ) {
180                     if ( strcmp ( v, g_categories [ n ].catname ) == 0 ) {
181                       break;
182                     }
183                   }
184                   if ( n < g_categorycount ) {
185                     if ( left && n ) {
186                       pnd_conf_set_char ( g_conf, page [ sel ].key, g_categories [ n - 1 ].catname );
187                     } else if ( ! left && n + 1 < g_categorycount ) {
188                       pnd_conf_set_char ( g_conf, page [ sel ].key, g_categories [ n + 1 ].catname );
189                     }
190                   } else {
191                     pnd_conf_set_char ( g_conf, page [ sel ].key, g_categories [ 0 ].catname );
192                   }
193                 } else {
194                   pnd_conf_set_char ( g_conf, page [ sel ].key, g_categories [ 0 ].catname );
195                 }
196               } // if category count
197             }
198             break;
199
200           case ct_boolean:
201             {
202               int v = pnd_conf_get_as_int ( g_conf, page [ sel ].key );
203               if ( v == PND_CONF_BADNUM ) {
204                 v = 0;
205               }
206               if ( v ) {
207                 v = 0;
208               } else {
209                 v = 1;
210               }
211
212               char buffer [ 20 ];
213               sprintf ( buffer, "%u", v );
214
215               pnd_conf_set_char ( g_conf, page [ sel ].key, buffer );
216             }
217             break;
218
219           case ct_filename:
220             break;
221
222           case ct_nil:
223           case ct_switch_page:
224           case ct_reset:
225           case ct_exit:
226             break;
227
228           } // switch
229
230         } else if ( event.key.keysym.sym == SDLK_ESCAPE ) {
231           emit_and_quit ( MM_QUIT );
232
233         } else if ( event.key.keysym.sym == SDLK_RETURN || event.key.keysym.sym == SDLK_END ) { // return, or "B"
234
235           switch ( page [ sel ].type ) {
236           case ct_exit:
237             {
238               return ( 1 /* always cause restart for now */ );
239             }
240             break;
241           case ct_reset:
242             {
243               conf_reset_to_default ( g_conf );
244               page = NULL;
245               sel = 0;
246             }
247             break;
248           case ct_switch_page:
249             page = page [ sel ].newhead;
250             sel = 0; // should use a stack..
251             break;
252           case ct_filename:
253             break;
254           case ct_nil:
255           case ct_visible_tab_list:
256           case ct_cpu_speed:
257           case ct_boolean:
258             break;
259           } // switch
260
261         } else {
262           // nada
263         }
264
265         break; // case sdl_key_up
266
267       } // switch what SDL event
268
269       break; // get out of sdl-wait-event loop
270     } // while events
271
272   } // while forever
273
274   return ( 1 /* always cause restart for now */ );
275 }
276
277 void conf_display_page ( confitem_t *page, unsigned int selitem, unsigned int first_visible, unsigned int max_visible ) {
278   extern TTF_Font *g_big_font;
279   extern TTF_Font *g_tab_font;
280
281 #define MAXRECTS 200
282   SDL_Rect rects [ MAXRECTS ];
283   SDL_Rect *dest = rects;
284   bzero ( dest, sizeof(SDL_Rect)*MAXRECTS );
285
286   unsigned short int tx, ty;
287
288   // background
289   if ( g_imagecache [ IMG_BACKGROUND_800480 ].i ) {
290     dest -> x = 0;
291     dest -> y = 0;
292     dest -> w = sdl_realscreen -> w;
293     dest -> h = sdl_realscreen -> h;
294     SDL_BlitSurface ( g_imagecache [ IMG_BACKGROUND_800480 ].i, NULL /* whole image */, sdl_realscreen, dest /* 0,0 */ );
295     dest++;
296   }
297
298   // title
299   //
300   // <items>
301   // description
302   // default
303   //
304   // controls help
305
306   // title
307   dest += conf_render_text ( g_big_font, "Minimenu Configuration", dest, 10, 10, CONF_UNSELECTED );
308   dest += conf_render_line ( dest, 45 );
309
310   // items
311   tx = 50; ty = 70;
312   unsigned char counter = first_visible;
313   while ( page [ counter ].text ) {
314
315     // item
316     conf_render_text ( g_tab_font, page [ counter ].text, dest, tx, ty, counter == selitem ? CONF_SELECTED : CONF_UNSELECTED );
317
318     // value
319     switch ( page [ counter ].type ) {
320     case ct_switch_page:
321       break;
322     case ct_reset:
323       break;
324     case ct_visible_tab_list:
325       {
326         char *v = pnd_conf_get_as_char ( g_conf, page [ counter ].key );
327         if ( v ) {
328           conf_render_text ( g_tab_font, v, dest, tx + 400, ty, counter == selitem ? CONF_SELECTED : CONF_UNSELECTED );
329         } else {
330           conf_render_text ( g_tab_font, "Not specified", dest, tx + 400, ty, counter == selitem ? CONF_SELECTED : CONF_UNSELECTED );
331         }
332       }
333       break;
334     case ct_cpu_speed:
335       {
336         int v = pnd_conf_get_as_int ( g_conf, page [ counter ].key );
337         conf_render_text ( g_tab_font, conf_format_int ( v, page [ counter ].type ), dest, tx + 400, ty, counter == selitem ? CONF_SELECTED : CONF_UNSELECTED );
338       }
339       break;
340     case ct_boolean:
341       {
342         int v = pnd_conf_get_as_int ( g_conf, page [ counter ].key );
343         conf_render_text ( g_tab_font, conf_format_int ( v, page [ counter ].type ), dest, tx + 400, ty, counter == selitem ? CONF_SELECTED : CONF_UNSELECTED );
344       }
345       break;
346     case ct_filename:
347       conf_render_text ( g_tab_font, page [ counter ].def, dest, tx + 400, ty, counter == selitem ? CONF_SELECTED : CONF_UNSELECTED );
348       break;
349     case ct_exit:
350       break;
351     case ct_nil:
352       break;
353     } // switch
354
355     // far enough?
356     if ( counter - first_visible >= max_visible - 1 ) {
357       break;
358     }
359
360     // next line
361     ty += 25;
362     counter++;
363   } // while
364
365   // description and default
366   if ( page [ selitem ].desc ) {
367     dest += conf_render_text ( g_tab_font, page [ selitem ].desc, dest, 380, 400, CONF_UNSELECTED );
368   }
369   if ( page [ selitem ].def ) {
370     char buffer [ 100 ] = "Default: ";
371
372     switch ( page [ selitem ].type ) {
373     case ct_boolean:
374       sprintf ( buffer + strlen ( buffer ), "%s", conf_format_int ( atoi ( page [ selitem ].def ), ct_boolean ) );
375       break;
376     case ct_cpu_speed:
377       sprintf ( buffer + strlen ( buffer ), "%s", conf_format_int ( atoi ( page [ selitem ].def ), ct_cpu_speed ) );
378       break;
379     case ct_filename:
380       sprintf ( buffer + strlen ( buffer ), "%s", page [ selitem ].def );
381       break;
382     case ct_nil:
383     case ct_switch_page:
384     case ct_reset:
385     case ct_exit:
386     case ct_visible_tab_list:
387       break;
388     } // switch
389
390     dest += conf_render_text ( g_tab_font, buffer, dest, 380, 420, CONF_UNSELECTED );
391   } else {
392     dest += conf_render_text ( g_tab_font, "No default value", dest, 380, 420, CONF_UNSELECTED );
393   }
394
395   // help
396   dest += conf_render_line ( dest, 380 );
397   dest += conf_render_text ( g_tab_font, "Up and down to switch selection", dest, 10, 400, CONF_UNSELECTED );
398   dest += conf_render_text ( g_tab_font, "Left and right to alter selected item", dest, 10, 420, CONF_UNSELECTED );
399   dest += conf_render_text ( g_tab_font, "B or Enter to activate an option", dest, 10, 440, CONF_UNSELECTED );
400
401   // update all the rects and send it all to sdl
402   // - at this point, we could probably just do 1 rect, of the
403   //   whole screen, and be faster :/
404   SDL_UpdateRects ( sdl_realscreen, dest - rects, rects );
405
406   return;
407 }
408
409 unsigned char conf_render_text ( TTF_Font *f, char *buffer, SDL_Rect *dest, unsigned int x, unsigned int y, unsigned char selected ) {
410   unsigned int font_rgba_r = pnd_conf_get_as_int_d ( g_conf, "display.font_rgba_r", 200 );
411   unsigned int font_rgba_g = pnd_conf_get_as_int_d ( g_conf, "display.font_rgba_g", 200 );
412   unsigned int font_rgba_b = pnd_conf_get_as_int_d ( g_conf, "display.font_rgba_b", 200 );
413   unsigned int font_rgba_a = pnd_conf_get_as_int_d ( g_conf, "display.font_rgba_a", 100 );
414
415   SDL_Color tmpfontcolor = { font_rgba_r, font_rgba_g, font_rgba_b, font_rgba_a };
416   SDL_Color selfontcolor = { 0/*font_rgba_r*/, font_rgba_g, font_rgba_b, font_rgba_a };
417
418   SDL_Surface *rtext = TTF_RenderText_Blended ( f, buffer, selected ? selfontcolor : tmpfontcolor );
419   dest -> x = x;
420   dest -> y = y;
421   SDL_BlitSurface ( rtext, NULL /* all */, sdl_realscreen, dest );
422   SDL_FreeSurface ( rtext );
423
424   return ( 1 );
425 }
426
427 unsigned char conf_render_line ( SDL_Rect *dest, unsigned int y ) {
428
429   dest -> x = 0;
430   dest -> y = y;
431
432   SDL_Surface *i = g_imagecache [ IMG_TAB_LINE ].i;
433
434   while ( dest -> x + i -> w < 800 ) {
435     SDL_BlitSurface ( i, NULL, sdl_realscreen, dest );
436     dest -> x += i -> w;
437   }
438
439   dest -> x = 0;
440   dest -> w = 480 - 10;
441   dest -> h = i -> h;
442
443   return ( 1 );
444 }
445
446 char *conf_format_int ( int v, change_type_e c ) {
447   static char buffer [ 50 ];
448   buffer [ 0 ] = '\0';
449
450   switch ( c ) {
451
452     case ct_cpu_speed:
453       {
454         if ( v == PND_CONF_BADNUM ) {
455           strcpy ( buffer, "Leave Alone" );
456         } else {
457           sprintf ( buffer, "%u", v );
458         }
459       }
460       break;
461
462     case ct_boolean:
463       {
464         if ( v == PND_CONF_BADNUM ) {
465           strcpy ( buffer, "FUBAR" );
466         } else if ( v == 0 ) {
467           strcpy ( buffer, "no" );
468         } else if ( v == 1 ) {
469           strcpy ( buffer, "yes" );
470         } else {
471           strcpy ( buffer, "FUBAR 2" );
472         }
473       }
474       break;
475
476   case ct_filename:
477     break;
478
479   case ct_exit:
480   case ct_reset:
481   case ct_switch_page:
482   case ct_visible_tab_list:
483   case ct_nil:
484     break;
485
486   } // switch
487
488   return ( buffer );
489 }
490
491 unsigned char conf_prepare_page ( confitem_t *page ) {
492   char buffer [ 100 ];
493
494   confitem_t *p = page;
495   confitem_t *template = NULL;
496   while ( p -> text != NULL ) {
497
498     if ( strcmp ( p -> text, CONF_APPLIST_TAG ) == 0 ) {
499       // rewrite this and subsequent items to be the listing
500       template = p;
501       p++;
502
503       template -> text = ""; // so it won't get repopulated again later
504
505       // for each app..
506       pnd_disco_t *iter = pnd_box_get_head ( g_active_apps );
507
508       while ( p - page < CONF_MAX_LISTLENGTH && iter ) {
509
510         p -> text = strndup ( iter -> title_en ? iter -> title_en : "Unnamed", 40 );
511         p -> desc = strdup ( iter -> unique_id );
512         p -> def = NULL;
513
514         sprintf ( buffer, "%s.%s", template -> key, iter -> unique_id );
515         p -> key = strdup ( buffer );
516         p -> type = ct_boolean;
517         p -> newhead = NULL;
518
519         // create to positive if not existant
520         if ( ! pnd_conf_get_as_char ( g_conf, buffer ) ) {
521           pnd_conf_set_char ( g_conf, buffer, "1" );
522         }
523
524         iter = pnd_box_get_next ( iter );
525         p++;
526       } // while not run off end of buffer
527
528       break;
529
530     } else if ( strcmp ( p -> text, CONF_TABLIST_TAG ) == 0 ) {
531       // rewrite this and subsequent items to be the listing
532       template = p;
533       p++;
534
535       template -> text = ""; // so it won't get repopulated again later
536
537       typedef struct {
538         mm_category_t *cat;
539         unsigned char n;
540       } _foo;
541       _foo cats [ 2 ];
542       cats [ 0 ].cat = g_categories;
543       cats [ 0 ].n = g_categorycount;
544       cats [ 1 ].cat = _categories_invis;
545       cats [ 1 ].n = _categories_inviscount;
546
547       // for each tab
548       unsigned int i, j;
549       for ( j = 0; j < 2; j++ ) {
550         mm_category_t *cc = cats [ j ].cat;
551         unsigned char cn = cats [ j ].n;
552         char catname [ 512 ];
553         char *actual_catname;
554
555         for ( i = 0;  i < cn; i++ ) {
556
557           // if this is an invisi-guy, it has parent-cat prepended; we want the real cat name.
558           strncpy ( catname, cc [ i ].catname, 500 );
559           if ( ( actual_catname = strchr ( catname, '.' ) ) ) {
560             actual_catname++; // skip the period
561           } else {
562             actual_catname = catname;
563           }
564           //fprintf ( stderr, "conf ui; got '%s' but showing '%s'\n", cc [ i ].catname, actual_catname );
565
566           if ( strncmp ( cc [ i ].catname, "All ", 4 ) == 0 ) {
567             // skip All tab, since it is generated, and managed by another config item
568             continue;
569           }
570
571           p -> text = strndup ( actual_catname, 40 );
572           p -> desc = NULL;
573           p -> def = NULL;
574
575           sprintf ( buffer, "%s.%s", template -> key, actual_catname );
576           p -> key = strdup ( buffer );
577           p -> type = ct_boolean;
578           p -> newhead = NULL;
579
580           // create to positive if not existant
581           if ( ! pnd_conf_get_as_char ( g_conf, buffer ) ) {
582             pnd_conf_set_char ( g_conf, buffer, "1" );
583           }
584
585           //fprintf ( stderr, "Created tabshow entry '%s'\n", cc [ i ].catname );
586
587           p++;
588         }
589
590       }
591
592       break;
593     }
594
595     p++;
596   }
597
598   return ( 1 );
599 }
600
601 unsigned char conf_write ( pnd_conf_handle h, char *fullpath ) {
602
603   // cherry pick the named keys from the conf-ui-array
604   // spill out the apps ands tabs 'broups' of conf keys
605
606   FILE *f = fopen ( fullpath, "w" );
607
608   if ( ! f ) {
609     return ( 0 );
610   }
611
612   fprintf ( f, "# Machine written; do not edit.\n" );
613   fprintf ( f, "# If you do edit, its KEY<tab>VALUE<newline>, nothing extra.\n" );
614   fprintf ( f, "\n" );
615
616   // deal with general keys
617   confitem_t *ci = page_general;
618   while ( ci -> text ) {
619     // does this item have a key? a value? if so, try to emit it.
620     if ( ci -> key ) {
621       char *v = pnd_conf_get_as_char ( h, ci -> key );
622       if ( v ) {
623         fprintf ( f, "%s\t%s\n", ci -> key, v );
624       }
625     }
626     ci++;
627   } // while
628
629   // deal with apps and tabs
630   char *v = pnd_box_get_head ( g_conf );
631   while ( v ) {
632
633     // does item begin with app or tab tag?
634     char *k = pnd_box_get_key ( v );
635
636     if ( k && 
637          ( strncasecmp ( k, "appshow.", 8 ) == 0 ||
638            strncasecmp ( k, "tabshow.", 8 ) == 0 )
639        )
640     {
641       fprintf ( f, "%s\t%s\n", k, v );
642     }
643
644     v = pnd_box_get_next ( v );
645   } // while
646
647   fclose ( f );
648
649   return ( 1 );
650 }
651
652 void conf_merge_into ( char *fullpath, pnd_conf_handle h ) {
653   FILE *f;
654   char buffer [ 1024 ];
655   char *s;
656
657   f = fopen ( fullpath, "r" );
658
659   if ( ! f ) {
660     return;
661   }
662
663   while ( fgets ( buffer, 1000, f ) ) {
664 #if 0
665     // trim trailing spaces
666     s = strchr ( buffer, ' ' );
667     if ( s ) {
668       *s = '\0';
669     }
670 #endif
671     // and #...
672     s = strchr ( buffer, '#' );
673     if ( s ) {
674       *s = '\0';
675     }
676     // and newline...
677     s = strchr ( buffer, '\n' );
678     if ( s ) {
679       *s = '\0';
680     }
681
682     // if theres anything left..
683     if ( buffer [ 0 ] != '\0' ) {
684
685       // assume FOO<tab>BAR<newline> since this really should be machine written, not human screwed with; or if human
686       // edited, assume they know what to do :) I even put in some 'docs' in the conf file.
687       char *s = strchr ( buffer, '\t' );
688
689       if ( s ) {
690         *s = '\0';
691
692         // set it; libpnd conf code already handles 'existant' or 'new'
693         pnd_conf_set_char ( h, buffer, s + 1 );
694
695       } // found a <tab>?
696
697     } // anything left?
698
699   } // while
700
701   fclose ( f );
702
703   return;
704 }
705
706 char *conf_determine_location ( pnd_conf_handle h ) {
707   static char path [ PATH_MAX ];
708
709   bzero ( path, PATH_MAX );
710
711   if ( ! getenv ( "HOME" ) ) {
712     return ( "." ); // wtf?
713   }
714
715   snprintf ( path, PATH_MAX - strlen(CONF_PREF_FILENAME) - 1, "%s/%s", getenv ( "HOME" ), CONF_PREF_FILENAME );
716
717   return ( path );
718 }
719
720 void conf_setup_missing ( pnd_conf_handle h ) {
721
722   confitem_t *ci = page_general;
723
724   while ( ci -> text ) {
725
726     // does this item have a default value?
727     if ( ci -> def ) {
728
729       // it does, so lets see if we can pull a current value in; if not, set one
730       char *v = pnd_conf_get_as_char ( h, ci -> key );
731
732       if ( ! v ) {
733         fprintf ( stderr, "pref conf: no value present in config, better set to default; key is '%s' def '%s'\n", ci -> key, ci -> def );
734         pnd_conf_set_char ( h, ci -> key, ci -> def );
735       }
736
737     } // has def?
738
739     ci++;
740   } // while
741
742   return;
743 }
744
745 void conf_reset_to_default ( pnd_conf_handle h ) {
746
747   // reset all keys to default value - if present
748   // reset all apps to show
749   // reset all tabs to show
750
751   // deal with general keys
752   confitem_t *ci = page_general;
753   while ( ci -> text ) {
754
755     // does this item have a default value? if so, set it
756     if ( ci -> key && ci -> def ) {
757       pnd_conf_set_char ( h, ci -> key, ci -> def );
758     }
759
760     ci++;
761   } // while
762
763   // deal with apps and tabs
764   char *v = pnd_box_get_head ( g_conf );
765   char *next;
766   while ( v ) {
767     next = pnd_box_get_next ( v );
768
769     // does item begin with app or tab tag?
770     char *k = pnd_box_get_key ( v );
771
772     if ( k && 
773          ( strncasecmp ( k, "appshow.", 8 ) == 0 ||
774            strncasecmp ( k, "tabshow.", 8 ) == 0 )
775        )
776     {
777       pnd_conf_set_char ( g_conf, k, "1" );
778     }
779
780     v = next;
781   } // while
782
783   return;
784 }
785