From 1b907dae072f2aa93d75d8c056a9bd02555a17f8 Mon Sep 17 00:00:00 2001 From: Robin Haberkorn Date: Mon, 3 Mar 2025 01:44:34 +0300 Subject: rename sample.teco_ini to fallback.teco_ini and mung it by default * After installation, SciTECO will therefore start into a more userfriendly mode even if the user does not create a custom ~/.teco_ini. It is hoped that this will scare away less of new users, who are not willing to read through all of the documentation. Still, users are warned in the absence of ~/.teco_ini. This warning however, might not be immediately visible, especially not when running gsciteco without an attached console. (This will change once I redo the UI and allow a number of messages to be queued in the message area.) * Theoretically, you could also just extend fallback.teco_ini from ~/.teco_ini, but that would require installing it into $SCITECOPATH. * Since the fallback profile will now be munged automatically on a wide range of systems, we set up xclip only when detecting X11 ($DISPLAY is non-empty). E.g. when running under Wayland or the Linux console, you still won't get the clipboard registers, which is probably better than having the clipboard operations fail once you try to use them. * xclip is now "suggested" on Debian/Ubuntu. Unfortunately we cannot pull it in only in the presence of X11. --- doc/sciteco.1.in | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/sciteco.1.in b/doc/sciteco.1.in index b7084c5..0d2662e 100644 --- a/doc/sciteco.1.in +++ b/doc/sciteco.1.in @@ -152,7 +152,11 @@ option is absent, \*(ST will mung On UNIX/Linux, the default profile is at .I ~/.teco_ini (see \fBENVIRONMENT\fP). -It will consequently not expect a \fIscript\fP file name as +If the per-user profile is missing, \*(ST falls back to +.IR @scitecodatadir@/fallback.teco_ini . +Without +.BR \-\-mung , +a \fIscript\fP file name will consequently not be expected as the first non-option argument. The profile will usually set up various Scintilla and \*(ST options, configure syntax highlighting, @@ -342,7 +346,7 @@ via \*(ST code. \# That would only be possible by rewriting everything with GSpawn. .SCITECO_TOPIC xclip See -.B @scitecodatadir@/sample.teco_ini +.B @scitecodatadir@/fallback.teco_ini for an example of how to integrate the X11 clipboard via .BR xclip (1). Integrating with Wayland and the Mac OS clipboards is of course also possible. @@ -398,8 +402,9 @@ program termination or user-programmed behaviour. .B $SCITECOCONFIG/.teco_ini Default profile macro. .TP -.B @scitecodatadir@/sample.teco_ini -Sample profile macro configuring commonly used run-time options, +.SCITECO_TOPIC "fallback.teco_ini" +.B @scitecodatadir@/fallback.teco_ini +Fallback profile macro configuring commonly used run-time options, syntax highlighting, session handling and opening files specified on the command line. .TP -- cgit v1.2.3