From cd5422e63f62d5e5d767a75b481f3802216b7983 Mon Sep 17 00:00:00 2001 From: Mohammad Abu Sakib Date: Sat, 6 Apr 2019 13:10:48 +0600 Subject: replace docbook link with xref and fix a linkend attribute (#30) This commit replaces link linkend with xref linkend, for cross-references to other parts of the manual, working around the yelp bug that most probably makes these cross-references nonfunctional. It also corrects a linkend attribute: gospanel-3 to bottom-panel in gosoverview.xml. --- mate-user-guide/C/goscaja.xml | 12 ++++++------ mate-user-guide/C/goscustdesk.xml | 10 +++++----- mate-user-guide/C/gosoverview.xml | 18 +++++++++--------- mate-user-guide/C/gospanel.xml | 16 ++++++++-------- mate-user-guide/C/gosstartsession.xml | 2 +- mate-user-guide/C/gostools.xml | 7 +++---- 6 files changed, 32 insertions(+), 33 deletions(-) diff --git a/mate-user-guide/C/goscaja.xml b/mate-user-guide/C/goscaja.xml index 9c7328c..7054ab0 100644 --- a/mate-user-guide/C/goscaja.xml +++ b/mate-user-guide/C/goscaja.xml @@ -67,7 +67,7 @@ file manager to do the following: lies behind all other visible items on your screen. The desktop is an active component of the way you use your computer. Every user has a Home Folder. The Home Folder contains all user's files. The desktop is another folder. The desktop contains special icons allowing easy access to the users Home Folder, Trash, and also removable media such as floppy disks, CDs and USB flash drives. - Caja is always running while you are using MATE. To open a new Caja window, double-click on an appropriate icon on the desktop such as Home or Computer, or choose an item from Places menu on the top panel. + Caja is always running while you are using MATE. To open a new Caja window, double-click on an appropriate icon on the desktop such as Home or Computer, or choose an item from on the top panel. In MATE many things are files, such as word processor documents, spreadsheets, photos, movies, and music. @@ -154,7 +154,7 @@ is an active component of the way you use your computer. Double-click the folder's icon on the desktop or an existing window Select the folder, and press CtrlO. Select the folder, and press Altdown arrow - Choose an item from the Places menu on the top panel. Your Home Folder and folders you have bookmarked are listed here. For more on bookmarks, see . + Choose an item from the on the top panel. Your Home Folder and folders you have bookmarked are listed here. For more on bookmarks, see . To close the current folder while opening the new one, hold down Shift when double-clicking, or press ShiftAltdown arrow. @@ -887,7 +887,7 @@ action for that file type. The file manager checks the contents of a file to determine the type of a file. If the first lines do not determine the type of the file, then the file manager checks the file extension. - If you open an executable text file, that is, one that Caja considers can be run as a program, then you will be asked what you want to do: run it, or display it in a text editor. You can modify this behavior in the File Management preferences. + If you open an executable text file, that is, one that Caja considers can be run as a program, then you will be asked what you want to do: run it, or display it in a text editor. You can modify this behavior in .
Executing the Default Action @@ -2230,7 +2230,7 @@ or folder to which a symbolic link points. Select the folder that you want to change. - Choose FileProperties. The properties window for the item is displayed. + Choose FileProperties. The for the item is displayed. Click on the Permissions tab. @@ -2301,7 +2301,7 @@ to a file or folder, perform the following steps: Select the file or folder to which you want to add a note. - Choose FileProperties. The properties window for the item is displayed. + Choose FileProperties. The for the item is displayed. Click on the Notes tab. In the Notes tabbed section, type the note. @@ -2750,7 +2750,7 @@ icon dialog click Revert. Select the item to which you want to add an emblem. - Right-click on the item, then choose Properties. The properties window for the item is displayed. + Right-click on the item, then choose Properties. The for the item is displayed. Click on the Emblems tab to display the Emblems tabbed section. diff --git a/mate-user-guide/C/goscustdesk.xml b/mate-user-guide/C/goscustdesk.xml index bd724a7..2473e81 100644 --- a/mate-user-guide/C/goscustdesk.xml +++ b/mate-user-guide/C/goscustdesk.xml @@ -129,7 +129,7 @@ keys that provides an alternative to standard ways of performing an action. For Desktop - These are general shortcuts for the whole desktop, such as logging out, locking the screen, opening the panel menubar, or launching a web browser. + These are general shortcuts for the whole desktop, such as logging out, locking your screen (see ), opening the panel menubar (see ), or launching a web browser. Sound Shortcuts for controlling your music player and the system volume. @@ -536,7 +536,7 @@ A Customize Theme dialog is displayed. backgrounds customizing desktop background - The desktop background is the image or color that is applied to your + The background is the image or color that is applied to your desktop. You can open Background tabbed section in the Appearance preference tool by right-clicking on the desktop and choosing Change Desktop Background, as well as from the SystemPreferences menu. You can customize the desktop background in the following ways: @@ -552,8 +552,8 @@ a solid color, or create a gradient effect with two colors. A gradient effect is a visual effect where one color blends gradually into another color. - You can also drag a color or a pattern to the desktop from the Backgrounds -and Emblems dialog in the Caja file manager. + You can also drag a color or a pattern to the desktop from the Backgrounds +and Emblems dialog in the Caja file manager (see ). lists the background preferences that you can modify. Desktop Background Preferences @@ -1447,7 +1447,7 @@ preference tool in the following functional areas: --> - To open the Keyboard Accessibility preference tool, click the Accessibility button. + To open the tool, click the Accessibility button.
Keyboard Preferences Use the General tabbed section to set general diff --git a/mate-user-guide/C/gosoverview.xml b/mate-user-guide/C/gosoverview.xml index 364cc36..2048fc5 100644 --- a/mate-user-guide/C/gosoverview.xml +++ b/mate-user-guide/C/gosoverview.xml @@ -122,7 +122,7 @@ As you work with your computer, the desktop becomes obscured by the windows you are working with. To quickly reveal the desktop by minimizing all windows, you can do one of the following: - Click on the Show Desktop button at the far left of the bottom panel. + Click on the Show Desktop button at the far left of the . Press CtrlAltD. @@ -233,7 +233,7 @@ Resize the window - Drag one of the borders to expand or contract the window on that side. Drag a corner to change two sides at once. The resize pointer appears when your mouse is in the correct position to begin the drag action. + Drag one of the borders to expand or contract the window on that side. Drag a corner to change two sides at once. The resize pointer (see ) appears when your mouse is in the correct position to begin the drag action. You can also choose Resize from the Window Menu, or press AltF8. The resize pointer appears. Move the mouse in the direction of the edge you want to resize, or press one of the keyboard arrows keys. The pointer changes to indicate the chosen edge. Now you can use the mouse or the arrow keys to move this edge of the window. Click the mouse or press Return to accept the change. Press Escape to cancel the resize action and return the window to its original size and shape. @@ -242,7 +242,7 @@ Minimize the window - Click on the Minimize button in the titlebar, the leftmost of the group of three on the right. This removes the window from view. The window can be restored to its previous position and size on the screen from the window list on the bottom edge panel or the window selector in the top panel. + Click on the Minimize button in the titlebar, the leftmost of the group of three on the right. This removes the window from view. The window can be restored to its previous position and size on the screen from the window list on the or the window selector in the top panel. You can also choose Minimize from the Window Menu, or press AltF9 @@ -316,7 +316,7 @@ With the keyboard, hold the Alt key and press the Tab key. A pop-up window appears with a list of icons representing each window. While still holding Alt, press Tab to move the selection along the list: a black rectangle frames the selected icon and the position of the window it corresponds to is highlighted with a black border. When the window you want to see is selected, release the Alt key. Using ShiftTab instead of just Tab cycles through the icons in reverse order. - You can customize the shortcut used to perform this action with the Keyboard Shortcuts preference tool. + You can customize the shortcut used to perform this action with the tool. @@ -333,7 +333,7 @@ Workspaces allow you to manage which windows are on your screen. You can imagine workspaces as being virtual screens, which you can switch between at any time. Every workspace contains the same desktop, the same panels, and the same menus. However, you can run different applications, and open different windows in each workspace. The applications in each workspace will remain there when you switch to other workspaces. - By default, four workspaces are available. You can switch between them with the Workspace Switcher applet at the right of the bottom panel. This shows a representation of your workspaces, by default a row of four rectangles. Click on one to switch to that workspace. In , Workspace Switcher contains four workspaces. The first three workspaces contain open windows. The last workspace does not contain currently open windows. The currently active workspace is highlighted. + By default, four workspaces are available. You can switch between them with the Workspace Switcher applet at the right of the . This shows a representation of your workspaces, by default a row of four rectangles. Click on one to switch to that workspace. In , Workspace Switcher contains four workspaces. The first three workspaces contain open windows. The last workspace does not contain currently open windows. The currently active workspace is highlighted.
Workspaces Displayed in Workspace Switcher @@ -411,7 +411,7 @@ specify the number of workspaces that you require. Dictionary allows you to look up definitions of a word. Image Viewer can display single image files, as well as large image collections. Character Map lets you choose letters and symbols from the Unicode character set and paste them into any application. If you are writing in several languages, not all the characters you need will be on your keyboard. - Caja File Manager displays your folders and their contents. Use this to copy, move and classify your files, and to access CDs, USB flash drives, and any other removable media. When you choose an item from the Places menu, a Caja File Manager window opens showing that location. + Caja File Manager (see ) displays your folders and their contents. Use this to copy, move and classify your files, and to access CDs, USB flash drives, and any other removable media. When you choose an item from the , a Caja File Manager window opens showing that location. Terminal gives you access to the system command line. @@ -426,7 +426,7 @@ specify the number of workspaces that you require. Consistent look-and-feel - MATE-compliant applications have a consistent look-and-feel. You can use the Appearance preference tool to change the look-and-feel of your MATE-compliant applications. + MATE-compliant applications have a consistent look-and-feel. You can use the tool to change the look-and-feel of your MATE-compliant applications. Menubars, toolbars, and statusbars @@ -474,7 +474,7 @@ specify the number of workspaces that you require. To change the location shown in the right-hand pane, do one of the following: Open a folder that is listed in the current location. - Open an item in the left-hand pane. This pane lists places such as your Documents folder, your Home Folder, media such as CDs and flash drives, places on your network, and your bookmarks. + Open an item in the left-hand pane. This pane lists places such as your Documents folder, your Home Folder, media such as CDs and flash drives, places on your network, and your bookmarks (see for more on bookmarks). Click one of the buttons in the path bar above the file listing pane. This shows the hierarchy of folders that contain your current location. Use the arrow buttons to either side of the button bar if the list of folders is too long to fit. @@ -524,7 +524,7 @@ specify the number of workspaces that you require.
Saving in another location To save the file in a location not listed in the drop-down list, click the Browse for other folders expansion label. This shows a file browser similar to the one in the Open File dialog. - The expanded Save File dialog has the same features as the Open File dialog, such as filtering, find-as-you-type, and adding and removing bookmarks. + The expanded Save File dialog has the same features as the Open File dialog (see ), such as filtering, find-as-you-type, and adding and removing bookmarks.
Replacing an existing file diff --git a/mate-user-guide/C/gospanel.xml b/mate-user-guide/C/gospanel.xml index 9928166..df202f8 100644 --- a/mate-user-guide/C/gospanel.xml +++ b/mate-user-guide/C/gospanel.xml @@ -265,7 +265,7 @@ buttons, if the hide button is enabled. - Select this option to have the panel use the settings in the Appearance preference tool. This keeps your panel's background looking the same as the rest of the desktop and applications. + Select this option to have the panel use the settings in the tool. This keeps your panel's background looking the same as the rest of the desktop and applications. @@ -319,8 +319,8 @@ many applications. For example: You can drag an image file from the Caja file manager to set it as the background of the panel. - You can drag a color or a pattern from the Backgrounds - and Emblems dialog in Caja file manager to a panel to set it as the background. + You can drag a color or a pattern from the Backgrounds + and Emblems dialog (see ) in Caja file manager to a panel to set it as the background. Click Close to close the Panel Properties dialog. @@ -356,7 +356,7 @@ buttons are now visible. You can set a panel to autohide. When you set autohide, the panel hides automatically when the mouse is not pointing to the panel. The panel reappears when you point to the part of the screen where the panel resides. To set your -panel to autohide, modify the properties of the panel. +panel to autohide, modify the properties of the panel as per the instructions in .
Adding a New Panel @@ -438,7 +438,7 @@ popup menu. Some applets have popup menus of applet-specific commands that open when you right-click on particular parts of the applet. For example, - the Window List applet has a vertical handle on + the applet has a vertical handle on the left side, and buttons that represent your windows on the right side. To open the panel object popup menu for the Window List applet, you must right-click on the handle. If you right-click on a button @@ -473,7 +473,7 @@ popup menu. Choose Add to Panel. - The Add to Panel dialog opens.The available panel objects are listed alphabetically, with launchers at the top. + The Add to Panel dialog opens.The available panel objects are listed alphabetically, with at the top. You can type a part of the name or description of an object in the find box. This will narrow the list to those objects that match what you type. To restore the full list, delete the text in the find box. @@ -739,7 +739,7 @@ ways: From the panel popup menu Right-click on any vacant space on the panel, -then choose Add to Panel. The Add to Panel dialog opens. +then choose Add to Panel. The Add to Panel dialog opens (see ). To create a new launcher, select Custom Application Launcher from the list. A Create Launcher dialog is displayed. For more information on the properties in this dialog, see . @@ -1107,7 +1107,7 @@ the same function as when you click on the Lock Screen bu - Opens the Screensaver preference tool, with which you can configure the type of screensaver that is displayed when you lock the screen. + Opens the tool, with which you can configure the type of screensaver that is displayed when you lock the screen. diff --git a/mate-user-guide/C/gosstartsession.xml b/mate-user-guide/C/gosstartsession.xml index fcd3da1..0504f3b 100644 --- a/mate-user-guide/C/gosstartsession.xml +++ b/mate-user-guide/C/gosstartsession.xml @@ -324,7 +324,7 @@ panel, click on the Lock Screen button. When you end a session, applications with unsaved work will warn you. You can choose to save your work, or cancel the command to log out or shut down. Before you end a session, you might want to save your current -settings so that you can restore the session later. In the Sessions preference tool, you can select an option to automatically +settings so that you can restore the session later. In the tool, you can select an option to automatically save your current settings.
\ No newline at end of file diff --git a/mate-user-guide/C/gostools.xml b/mate-user-guide/C/gostools.xml index 8f263de..1fca3f2 100644 --- a/mate-user-guide/C/gostools.xml +++ b/mate-user-guide/C/gostools.xml @@ -37,8 +37,8 @@ Press AltF2. You can change the shortcut keys that display the Run Application dialog - in the Keyboard Shortcuts - preference tool. + in the tool. + @@ -121,8 +121,7 @@ a screenshot of the entire screen. - You can use the Keyboard Shortcuts - preference tool to modify the default shortcut keys. + You can use the tool to modify the default shortcut keys. From the Menubar -- cgit v1.2.1