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