src/xrdb.c

   1 /* Deal with the X Resource Manager.
   2    Copyright (C) 1990, 1993, 1994, 2000, 2001, 2002, 2003, 2004,
   3                  2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
   4
   5 Author: Joseph Arceneaux
   6 Created: 4/90
   7
   8 This file is part of GNU Emacs.
   9
  10 GNU Emacs is free software: you can redistribute it and/or modify
  11 it under the terms of the GNU General Public License as published by
  12 the Free Software Foundation, either version 3 of the License, or
  13 (at your option) any later version.
  14
  15 GNU Emacs is distributed in the hope that it will be useful,
  16 but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 GNU General Public License for more details.
  19
  20 You should have received a copy of the GNU General Public License
  21 along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.  */
  22
  23 #include <config.h>
  24
  25 #ifdef HAVE_UNISTD_H
  26 #include <unistd.h>
  27 #endif
  28
  29 #include <errno.h>
  30 #include <epaths.h>
  31
  32 #include <stdio.h>
  33 #include <setjmp.h>
  34
  35 #include <X11/Xlib.h>
  36 #include <X11/Xatom.h>
  37 #include <X11/X.h>
  38 #include <X11/Xutil.h>
  39 #include <X11/Xresource.h>
  40 #ifdef HAVE_PWD_H
  41 #include <pwd.h>
  42 #endif
  43 #include <sys/stat.h>
  44
  45 #if !defined(S_ISDIR) && defined(S_IFDIR)
  46 #define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
  47 #endif
  48
  49 #include "lisp.h"
  50
  51 #ifdef USE_MOTIF
  52 /* For Vdouble_click_time.  */
  53 #include "keyboard.h"
  54 #endif
  55
  56 extern char *getenv (const char *);
  57
  58 extern struct passwd *getpwuid (uid_t);
  59 extern struct passwd *getpwnam (const char *);
  60
  61 extern const char *get_system_name (void);
  62
  63 char *x_get_string_resource (XrmDatabase rdb, const char *name,
  64                              const char *class);
  65 static int file_p (const char *filename);
  66
  67 \f
  68 /* X file search path processing.  */
  69
  70
  71 /* The string which gets substituted for the %C escape in XFILESEARCHPATH
  72    and friends, or zero if none was specified.  */
  73 char *x_customization_string;
  74
  75
  76 /* Return the value of the emacs.customization (Emacs.Customization)
  77    resource, for later use in search path decoding.  If we find no
  78    such resource, return zero.  */
  79 static char *
  80 x_get_customization_string (XrmDatabase db, const char *name,
  81                             const char *class)
  82 {
  83   char *full_name
  84     = (char *) alloca (strlen (name) + sizeof ("customization") + 3);
  85   char *full_class
  86     = (char *) alloca (strlen (class) + sizeof ("Customization") + 3);
  87   char *result;
  88
  89   sprintf (full_name,  "%s.%s", name,  "customization");
  90   sprintf (full_class, "%s.%s", class, "Customization");
  91
  92   result = x_get_string_resource (db, full_name, full_class);
  93
  94   if (result)
  95     {
  96       char *copy = (char *) xmalloc (strlen (result) + 1);
  97       strcpy (copy, result);
  98       return copy;
  99     }
 100   else
 101     return 0;
 102 }
 103
 104
 105 /* Expand all the Xt-style %-escapes in STRING, whose length is given
 106    by STRING_LEN.  Here are the escapes we're supposed to recognize:
 107
 108         %N      The value of the application's class name
 109         %T      The value of the type parameter ("app-defaults" in this
 110                 context)
 111         %S      The value of the suffix parameter ("" in this context)
 112         %L      The language string associated with the specified display
 113                 (We use the "LANG" environment variable here, if it's set.)
 114         %l      The language part of the display's language string
 115                 (We treat this just like %L.  If someone can tell us what
 116                  we're really supposed to do, dandy.)
 117         %t      The territory part of the display's language string
 118                 (This never gets used.)
 119         %c      The codeset part of the display's language string
 120                 (This never gets used either.)
 121         %C      The customization string retrieved from the resource
 122                 database associated with display.
 123                 (This is x_customization_string.)
 124
 125    Return the expanded file name if it exists and is readable, and
 126    refers to %L only when the LANG environment variable is set, or
 127    otherwise provided by X.
 128
 129    ESCAPED_SUFFIX and SUFFIX are postpended to STRING if they are
 130    non-zero.  %-escapes in ESCAPED_SUFFIX are expanded; STRING is left
 131    alone.
 132
 133    Return NULL otherwise.  */
 134
 135 static char *
 136 magic_file_p (const char *string, EMACS_INT string_len, const char *class, const char *escaped_suffix, const char *suffix)
 137 {
 138   char *lang = getenv ("LANG");
 139
 140   int path_size = 100;
 141   char *path = (char *) xmalloc (path_size);
 142   int path_len = 0;
 143
 144   const char *p = string;
 145
 146   while (p < string + string_len)
 147     {
 148       /* The chunk we're about to stick on the end of result.  */
 149       const char *next = NULL;
 150       int next_len;
 151
 152       if (*p == '%')
 153         {
 154           p++;
 155
 156           if (p >= string + string_len)
 157             next_len = 0;
 158           else
 159             switch (*p)
 160               {
 161               case '%':
 162                 next = "%";
 163                 next_len = 1;
 164                 break;
 165
 166               case 'C':
 167                 next = (x_customization_string
 168                         ? x_customization_string
 169                         : "");
 170                 next_len = strlen (next);
 171                 break;
 172
 173               case 'N':
 174                 next = class;
 175                 next_len = strlen (class);
 176                 break;
 177
 178               case 'T':
 179                 next = "app-defaults";
 180                 next_len = strlen (next);
 181                 break;
 182
 183               default:
 184               case 'S':
 185                 next_len = 0;
 186                 break;
 187
 188               case 'L':
 189               case 'l':
 190                 if (! lang)
 191                   {
 192                     xfree (path);
 193                     return NULL;
 194                   }
 195
 196                 next = lang;
 197                 next_len = strlen (next);
 198                 break;
 199
 200               case 't':
 201               case 'c':
 202                 xfree (path);
 203                 return NULL;
 204               }
 205         }
 206       else
 207         next = p, next_len = 1;
 208
 209       /* Do we have room for this component followed by a '\0' ?  */
 210       if (path_len + next_len + 1 > path_size)
 211         {
 212           path_size = (path_len + next_len + 1) * 2;
 213           path = (char *) xrealloc (path, path_size);
 214         }
 215
 216       memcpy (path + path_len, next, next_len);
 217       path_len += next_len;
 218
 219       p++;
 220
 221       /* If we've reached the end of the string, append ESCAPED_SUFFIX.  */
 222       if (p >= string + string_len && escaped_suffix)
 223         {
 224           string = escaped_suffix;
 225           string_len = strlen (string);
 226           p = string;
 227           escaped_suffix = NULL;
 228         }
 229     }
 230
 231   /* Perhaps we should add the SUFFIX now.  */
 232   if (suffix)
 233     {
 234       int suffix_len = strlen (suffix);
 235
 236       if (path_len + suffix_len + 1 > path_size)
 237         {
 238           path_size = (path_len + suffix_len + 1);
 239           path = (char *) xrealloc (path, path_size);
 240         }
 241
 242       memcpy (path + path_len, suffix, suffix_len);
 243       path_len += suffix_len;
 244     }
 245
 246   path[path_len] = '\0';
 247
 248   if (! file_p (path))
 249     {
 250       xfree (path);
 251       return NULL;
 252     }
 253
 254   return path;
 255 }
 256
 257
 258 static char *
 259 gethomedir (void)
 260 {
 261   struct passwd *pw;
 262   char *ptr;
 263   char *copy;
 264
 265   if ((ptr = getenv ("HOME")) == NULL)
 266     {
 267       if ((ptr = getenv ("LOGNAME")) != NULL
 268           || (ptr = getenv ("USER")) != NULL)
 269         pw = getpwnam (ptr);
 270       else
 271         pw = getpwuid (getuid ());
 272
 273       if (pw)
 274         ptr = pw->pw_dir;
 275     }
 276
 277   if (ptr == NULL)
 278     return xstrdup ("/");
 279
 280   copy = (char *) xmalloc (strlen (ptr) + 2);
 281   strcpy (copy, ptr);
 282   strcat (copy, "/");
 283
 284   return copy;
 285 }
 286
 287
 288 static int
 289 file_p (const char *filename)
 290 {
 291   struct stat status;
 292
 293   return (access (filename, 4) == 0             /* exists and is readable */
 294           && stat (filename, &status) == 0      /* get the status */
 295           && (S_ISDIR (status.st_mode)) == 0);  /* not a directory */
 296 }
 297
 298
 299 /* Find the first element of SEARCH_PATH which exists and is readable,
 300    after expanding the %-escapes.  Return 0 if we didn't find any, and
 301    the path name of the one we found otherwise.  */
 302
 303 static char *
 304 search_magic_path (const char *search_path, const char *class, const char *escaped_suffix, const char *suffix)
 305 {
 306   const char *s, *p;
 307
 308   for (s = search_path; *s; s = p)
 309     {
 310       for (p = s; *p && *p != ':'; p++)
 311         ;
 312
 313       if (p > s)
 314         {
 315           char *path = magic_file_p (s, p - s, class, escaped_suffix,
 316                                            suffix);
 317           if (path)
 318             return path;
 319         }
 320       else if (*p == ':')
 321         {
 322           char *path;
 323
 324           s = "%N%S";
 325           path = magic_file_p (s, strlen (s), class, escaped_suffix, suffix);
 326           if (path)
 327             return path;
 328         }
 329
 330       if (*p == ':')
 331         p++;
 332     }
 333
 334   return 0;
 335 }
 336 \f
 337 /* Producing databases for individual sources.  */
 338
 339 static XrmDatabase
 340 get_system_app (const char *class)
 341 {
 342   XrmDatabase db = NULL;
 343   const char *path;
 344   char *p;
 345
 346   path = getenv ("XFILESEARCHPATH");
 347   if (! path) path = PATH_X_DEFAULTS;
 348
 349   p = search_magic_path (path, class, 0, 0);
 350   if (p)
 351     {
 352       db = XrmGetFileDatabase (p);
 353       xfree (p);
 354     }
 355
 356   return db;
 357 }
 358
 359
 360 static XrmDatabase
 361 get_fallback (Display *display)
 362 {
 363   return NULL;
 364 }
 365
 366
 367 static XrmDatabase
 368 get_user_app (const char *class)
 369 {
 370   const char *path;
 371   char *file = 0;
 372   char *free_it = 0;
 373
 374   /* Check for XUSERFILESEARCHPATH.  It is a path of complete file
 375      names, not directories.  */
 376   if (((path = getenv ("XUSERFILESEARCHPATH"))
 377        && (file = search_magic_path (path, class, 0, 0)))
 378
 379       /* Check for APPLRESDIR; it is a path of directories.  In each,
 380          we have to search for LANG/CLASS and then CLASS.  */
 381       || ((path = getenv ("XAPPLRESDIR"))
 382           && ((file = search_magic_path (path, class, "/%L/%N", 0))
 383               || (file = search_magic_path (path, class, "/%N", 0))))
 384
 385       /* Check in the home directory.  This is a bit of a hack; let's
 386          hope one's home directory doesn't contain any %-escapes.  */
 387       || (free_it = gethomedir (),
 388           ((file = search_magic_path (free_it, class, "%L/%N", 0))
 389            || (file = search_magic_path (free_it, class, "%N", 0)))))
 390     {
 391       XrmDatabase db = XrmGetFileDatabase (file);
 392       xfree (file);
 393       xfree (free_it);
 394       return db;
 395     }
 396
 397   xfree (free_it);
 398   return NULL;
 399 }
 400
 401
 402 static XrmDatabase
 403 get_user_db (Display *display)
 404 {
 405   XrmDatabase db;
 406   char *xdefs;
 407
 408 #ifdef PBaseSize                /* Cheap way to test for X11R4 or later.  */
 409   xdefs = XResourceManagerString (display);
 410 #else
 411   xdefs = display->xdefaults;
 412 #endif
 413
 414   if (xdefs != NULL)
 415     db = XrmGetStringDatabase (xdefs);
 416   else
 417     {
 418       char *home;
 419       char *xdefault;
 420
 421       home = gethomedir ();
 422       xdefault = (char *) xmalloc (strlen (home) + sizeof (".Xdefaults"));
 423       strcpy (xdefault, home);
 424       strcat (xdefault, ".Xdefaults");
 425       db = XrmGetFileDatabase (xdefault);
 426       xfree (home);
 427       xfree (xdefault);
 428     }
 429
 430 #ifdef HAVE_XSCREENRESOURCESTRING
 431   /* Get the screen-specific resources too.  */
 432   xdefs = XScreenResourceString (DefaultScreenOfDisplay (display));
 433   if (xdefs != NULL)
 434     {
 435       XrmMergeDatabases (XrmGetStringDatabase (xdefs), &db);
 436       XFree (xdefs);
 437     }
 438 #endif
 439
 440   return db;
 441 }
 442
 443 static XrmDatabase
 444 get_environ_db (void)
 445 {
 446   XrmDatabase db;
 447   char *p;
 448   char *path = 0, *home = 0;
 449   const char *host;
 450
 451   if ((p = getenv ("XENVIRONMENT")) == NULL)
 452     {
 453       home = gethomedir ();
 454       host = get_system_name ();
 455       path = (char *) xmalloc (strlen (home)
 456                               + sizeof (".Xdefaults-")
 457                               + strlen (host));
 458       sprintf (path, "%s%s%s", home, ".Xdefaults-", host);
 459       p = path;
 460     }
 461
 462   db = XrmGetFileDatabase (p);
 463
 464   xfree (path);
 465   xfree (home);
 466
 467   return db;
 468 }
 469 \f
 470 /* External interface.  */
 471
 472 /* Types of values that we can find in a database */
 473
 474 #define XrmStringType "String"  /* String representation */
 475 XrmRepresentation x_rm_string;  /* Quark representation */
 476
 477 /* Load X resources based on the display and a possible -xrm option. */
 478
 479 XrmDatabase
 480 x_load_resources (Display *display, const char *xrm_string,
 481                   const char *myname, const char *myclass)
 482 {
 483   XrmDatabase user_database;
 484   XrmDatabase rdb;
 485   XrmDatabase db;
 486   char line[256];
 487
 488   const char *helv = "-*-helvetica-medium-r-*--*-120-*-*-*-*-iso8859-1";
 489
 490 #ifdef USE_MOTIF
 491   const char *courier = "-*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1";
 492 #endif
 493
 494   x_rm_string = XrmStringToQuark (XrmStringType);
 495 #ifndef USE_X_TOOLKIT
 496   /* pmr@osf.org says this shouldn't be done if USE_X_TOOLKIT.
 497      I suspect it's because the toolkit version does this elsewhere.  */
 498   XrmInitialize ();
 499 #endif
 500   rdb = XrmGetStringDatabase ("");
 501
 502   /* Add some font defaults.  If the font `helv' doesn't exist, widgets
 503      will use some other default font.  */
 504 #ifdef USE_MOTIF
 505
 506   sprintf (line, "%s.pane.background: grey75", myclass);
 507   XrmPutLineResource (&rdb, line);
 508   sprintf (line, "%s*fontList: %s", myclass, helv);
 509   XrmPutLineResource (&rdb, line);
 510   sprintf (line, "%s*menu*background: grey75", myclass);
 511   XrmPutLineResource (&rdb, line);
 512   sprintf (line, "%s*menubar*background: grey75", myclass);
 513   XrmPutLineResource (&rdb, line);
 514   sprintf (line, "%s*verticalScrollBar.background: grey75", myclass);
 515   XrmPutLineResource (&rdb, line);
 516   sprintf (line, "%s*verticalScrollBar.troughColor: grey75", myclass);
 517   XrmPutLineResource (&rdb, line);
 518   sprintf (line, "%s.dialog*.background: grey75", myclass);
 519   XrmPutLineResource (&rdb, line);
 520   sprintf (line, "%s*fsb.Text.background: white", myclass);
 521   XrmPutLineResource (&rdb, line);
 522   sprintf (line, "%s*fsb.FilterText.background: white", myclass);
 523   XrmPutLineResource (&rdb, line);
 524   sprintf (line, "%s*fsb*DirList.background: white", myclass);
 525   XrmPutLineResource (&rdb, line);
 526   sprintf (line, "%s*fsb*ItemsList.background: white", myclass);
 527   XrmPutLineResource (&rdb, line);
 528   sprintf (line, "%s*fsb*background: grey75", myclass);
 529   XrmPutLineResource (&rdb, line);
 530   sprintf (line, "%s*fsb.Text.fontList: %s", myclass, courier);
 531   XrmPutLineResource (&rdb, line);
 532   sprintf (line, "%s*fsb.FilterText.fontList: %s", myclass, courier);
 533   XrmPutLineResource (&rdb, line);
 534   sprintf (line, "%s*fsb*ItemsList.fontList: %s", myclass, courier);
 535   XrmPutLineResource (&rdb, line);
 536   sprintf (line, "%s*fsb*DirList.fontList: %s", myclass, courier);
 537   XrmPutLineResource (&rdb, line);
 538
 539   /* Set double click time of list boxes in the file selection
 540      dialog from `double-click-time'.  */
 541   if (INTEGERP (Vdouble_click_time) && XINT (Vdouble_click_time) > 0)
 542     {
 543       sprintf (line, "%s*fsb*DirList.doubleClickInterval: %d",
 544                myclass, XFASTINT (Vdouble_click_time));
 545       XrmPutLineResource (&rdb, line);
 546       sprintf (line, "%s*fsb*ItemsList.doubleClickInterval: %d",
 547                myclass, XFASTINT (Vdouble_click_time));
 548       XrmPutLineResource (&rdb, line);
 549     }
 550
 551 #else /* not USE_MOTIF */
 552
 553   sprintf (line, "Emacs.dialog*.font: %s", helv);
 554   XrmPutLineResource (&rdb, line);
 555   sprintf (line, "Emacs.dialog*.background: grey75");
 556   XrmPutLineResource (&rdb, line);
 557   sprintf (line, "*XlwMenu*font: %s", helv);
 558   XrmPutLineResource (&rdb, line);
 559   sprintf (line, "*XlwMenu*background: grey75");
 560   XrmPutLineResource (&rdb, line);
 561   sprintf (line, "Emacs*verticalScrollBar.background: grey75");
 562   XrmPutLineResource (&rdb, line);
 563
 564 #endif /* not USE_MOTIF */
 565
 566   user_database = get_user_db (display);
 567
 568   /* Figure out what the "customization string" is, so we can use it
 569      to decode paths.  */
 570   xfree (x_customization_string);
 571   x_customization_string
 572     = x_get_customization_string (user_database, myname, myclass);
 573
 574   /* Get application system defaults */
 575   db = get_system_app (myclass);
 576   if (db != NULL)
 577     XrmMergeDatabases (db, &rdb);
 578
 579   /* Get Fallback resources */
 580   db = get_fallback (display);
 581   if (db != NULL)
 582     XrmMergeDatabases (db, &rdb);
 583
 584   /* Get application user defaults */
 585   db = get_user_app (myclass);
 586   if (db != NULL)
 587     XrmMergeDatabases (db, &rdb);
 588
 589   /* get User defaults */
 590   if (user_database != NULL)
 591     XrmMergeDatabases (user_database, &rdb);
 592
 593   /* Get Environment defaults. */
 594   db = get_environ_db ();
 595   if (db != NULL)
 596     XrmMergeDatabases (db, &rdb);
 597
 598   /* Last, merge in any specification from the command line. */
 599   if (xrm_string != NULL)
 600     {
 601       db = XrmGetStringDatabase (xrm_string);
 602       if (db != NULL)
 603         XrmMergeDatabases (db, &rdb);
 604     }
 605
 606   return rdb;
 607 }
 608
 609
 610 /* Retrieve the value of the resource specified by NAME with class CLASS
 611    and of type TYPE from database RDB.  The value is returned in RET_VALUE. */
 612
 613 static int
 614 x_get_resource (XrmDatabase rdb, const char *name, const char *class,
 615                 XrmRepresentation expected_type, XrmValue *ret_value)
 616 {
 617   XrmValue value;
 618   XrmName namelist[100];
 619   XrmClass classlist[100];
 620   XrmRepresentation type;
 621
 622   XrmStringToNameList(name, namelist);
 623   XrmStringToClassList(class, classlist);
 624
 625   if (XrmQGetResource (rdb, namelist, classlist, &type, &value) == True
 626       && (type == expected_type))
 627     {
 628       if (type == x_rm_string)
 629         ret_value->addr = (char *) value.addr;
 630       else
 631         memcpy (ret_value->addr, value.addr, ret_value->size);
 632
 633       return value.size;
 634     }
 635
 636   return 0;
 637 }
 638
 639 /* Retrieve the string resource specified by NAME with CLASS from
 640    database RDB. */
 641
 642 char *
 643 x_get_string_resource (XrmDatabase rdb, const char *name, const char *class)
 644 {
 645   XrmValue value;
 646
 647   if (inhibit_x_resources)
 648     /* --quick was passed, so this is a no-op.  */
 649     return NULL;
 650
 651   if (x_get_resource (rdb, name, class, x_rm_string, &value))
 652     return (char *) value.addr;
 653
 654   return (char *) 0;
 655 }
 656 \f
 657 /* Stand-alone test facilities.  */
 658
 659 #ifdef TESTRM
 660
 661 typedef char **List;
 662 #define arg_listify(len, list) (list)
 663 #define car(list) (*(list))
 664 #define cdr(list) (list + 1)
 665 #define NIL(list) (! *(list))
 666 #define free_arglist(list)
 667
 668 static List
 669 member (elt, list)
 670      char *elt;
 671      List list;
 672 {
 673   List p;
 674
 675   for (p = list; ! NIL (p); p = cdr (p))
 676     if (! strcmp (elt, car (p)))
 677       return p;
 678
 679   return p;
 680 }
 681
 682 static void
 683 fatal (msg, prog, x1, x2, x3, x4, x5)
 684     char *msg, *prog;
 685     int x1, x2, x3, x4, x5;
 686 {
 687     if (errno)
 688       perror (prog);
 689
 690     (void) fprintf (stderr, msg, prog, x1, x2, x3, x4, x5);
 691     exit (1);
 692 }
 693
 694 main (argc, argv)
 695     int argc;
 696     char **argv;
 697 {
 698   Display *display;
 699   char *displayname, *resource_string, *class, *name;
 700   XrmDatabase xdb;
 701   List arg_list, lp;
 702
 703   arg_list = arg_listify (argc, argv);
 704
 705   lp = member ("-d", arg_list);
 706   if (!NIL (lp))
 707     displayname = car (cdr (lp));
 708   else
 709     displayname = "localhost:0.0";
 710
 711   lp = member ("-xrm", arg_list);
 712   if (! NIL (lp))
 713     resource_string = car (cdr (lp));
 714   else
 715     resource_string = (char *) 0;
 716
 717   lp = member ("-c", arg_list);
 718   if (! NIL (lp))
 719     class = car (cdr (lp));
 720   else
 721     class = "Emacs";
 722
 723   lp = member ("-n", arg_list);
 724   if (! NIL (lp))
 725     name = car (cdr (lp));
 726   else
 727     name = "emacs";
 728
 729   free_arglist (arg_list);
 730
 731   if (!(display = XOpenDisplay (displayname)))
 732     fatal ("Can't open display '%s'\n", XDisplayName (displayname));
 733
 734   xdb = x_load_resources (display, resource_string, name, class);
 735
 736   /* In a real program, you'd want to also do this: */
 737   display->db = xdb;
 738
 739   while (1)
 740     {
 741       char query_name[90];
 742       char query_class[90];
 743
 744       printf ("Name: ");
 745       gets (query_name);
 746
 747       if (strlen (query_name))
 748         {
 749           char *value;
 750
 751           printf ("Class: ");
 752           gets (query_class);
 753
 754           value = x_get_string_resource (xdb, query_name, query_class);
 755
 756           if (value != NULL)
 757             printf ("\t%s(%s):  %s\n\n", query_name, query_class, value);
 758           else
 759             printf ("\tNo Value.\n\n");
 760         }
 761       else
 762         break;
 763     }
 764   printf ("\tExit.\n\n");
 765
 766   XCloseDisplay (display);
 767 }
 768 #endif /* TESTRM */
 769
 770 /* arch-tag: 37e6fbab-ed05-4363-9e76-6c4109ed511f
 771    (do not change this comment) */