Bug 126555 - Undocumented that "Distribution…" will be missing unless 3 or more objects are selected
Summary: Undocumented that "Distribution…" will be missing unless 3 or more objects ar...
Status: RESOLVED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
6.2.5.2 release
Hardware: All Linux (All)
: medium normal
Assignee: Roman Kuznetsov
URL:
Whiteboard: target:7.2.0
Keywords:
Depends on:
Blocks: Help-Changes-Menu
  Show dependency treegraph
 
Reported: 2019-07-26 00:14 UTC by Konstantin Kharlamov
Modified: 2022-04-06 13:03 UTC (History)
4 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Konstantin Kharlamov 2019-07-26 00:14:48 UTC
According to wiki¹ and a video tutorial I found, it should be in context menu. But it's not there, and tests of various similarly named options didn't yield a similar result for me, i.e. doesn't look like it was renamed.

# Steps to reproduce

1. Open loimpress, press Cancel in "Templates" window to get past it
2. Put 2 rectangles on the slide
3. Select them both by holding Alt, and clicking each of them
4. Right click the selected rectangles

## Expected

There's a "Distribution…" menu to distribute objects evenly with relation to each other.

## Actual

There's no "Distribution…" menu.

1: https://help.libreoffice.org/Common/Distribution
Comment 1 raal 2019-07-26 04:50:09 UTC
Please attach link to the video. I doesn't see this menu item in 6.4, but also in some older versions (tested 5.0, 6.1). Thanks
Comment 2 V Stuart Foote 2019-07-26 14:07:30 UTC
Not missing, the button action is on resident on the Drawing toolbar (and several Notebook Bar panels) but it is available to add by customization to the Context menu.

Done simply:

Impress (or Draw) session, Tools -> Customize -> "Context menus" tab

Select "Target" as 'Shape' via droplist (on opening it is pointint to 3D Object)

In "Search" box type "distri", select the "Distribution" widget

Use the "Add item" arrow to move the "Distribution" widget into the context menu.

Use the "Move up"/"Move up" arrows to position where you prefer.

OK out. May need to close Impress session at 6.2, immediate for current master/6.4

Context menu action is then available to distribute shapes via the popup "Distribution" dialog.
Comment 3 V Stuart Foote 2019-07-26 14:39:10 UTC
Also, Distribution is on the main menus for Draw and Impress with ellipsis indicating the popup dialog.

Draw -> Shape menu

Impress -> Format menu

That Wiki help dates from 2011. But the online & local help articles [1][2] need do need to be updated.

So, it is a valid documentation issue... => NEW

=-ref-=
[1] https://help.libreoffice.org/6.2/en-US/text/shared/01/05360000.html
[2] https://help.libreoffice.org/6.2/en-US/text/sdraw/guide/align_arrange.html
Comment 4 Konstantin Kharlamov 2019-07-26 23:03:58 UTC
(In reply to V Stuart Foote from comment #2)
> Not missing, the button action is on resident on the Drawing toolbar (and
> several Notebook Bar panels) but it is available to add by customization to
> the Context menu.
> 
> Done simply:
> 
> Impress (or Draw) session, Tools -> Customize -> "Context menus" tab
> 
> Select "Target" as 'Shape' via droplist (on opening it is pointint to 3D
> Object)
> 
> In "Search" box type "distri", select the "Distribution" widget
> 
> Use the "Add item" arrow to move the "Distribution" widget into the context
> menu.
> 
> Use the "Move up"/"Move up" arrows to position where you prefer.
> 
> OK out. May need to close Impress session at 6.2, immediate for current
> master/6.4
> 
> Context menu action is then available to distribute shapes via the popup
> "Distribution" dialog.

I just did that, restarted, and menu is still missing. I can see it in "Customize" below "Convert", but it's not in context menu.

Also, I found the "Distribution" icon you mentioned on the drawing toolbar, and it's grayed out when I select the rectangles. Does it behave for you differently?
Comment 5 Konstantin Kharlamov 2019-07-26 23:15:03 UTC
(In reply to Konstantin Kharlamov from comment #4)
> (In reply to V Stuart Foote from comment #2)
> > Not missing, the button action is on resident on the Drawing toolbar (and
> > several Notebook Bar panels) but it is available to add by customization to
> > the Context menu.
> > 
> > Done simply:
> > 
> > Impress (or Draw) session, Tools -> Customize -> "Context menus" tab
> > 
> > Select "Target" as 'Shape' via droplist (on opening it is pointint to 3D
> > Object)
> > 
> > In "Search" box type "distri", select the "Distribution" widget
> > 
> > Use the "Add item" arrow to move the "Distribution" widget into the context
> > menu.
> > 
> > Use the "Move up"/"Move up" arrows to position where you prefer.
> > 
> > OK out. May need to close Impress session at 6.2, immediate for current
> > master/6.4
> > 
> > Context menu action is then available to distribute shapes via the popup
> > "Distribution" dialog.
> 
> I just did that, restarted, and menu is still missing. I can see it in
> "Customize" below "Convert", but it's not in context menu.
> 
> Also, I found the "Distribution" icon you mentioned on the drawing toolbar,
> and it's grayed out when I select the rectangles. Does it behave for you
> differently?

Ah, I see, nvm: the option only appears when there's more than 3 items selected.
Comment 6 Konstantin Kharlamov 2019-07-26 23:15:59 UTC
(In reply to Konstantin Kharlamov from comment #5) 
> Ah, I see, nvm: the option only appears when there's more than 3 items
> selected.

*three or more items selected.
Comment 7 Konstantin Kharlamov 2019-07-26 23:26:14 UTC
Okay, so, this is odd, but apparently it's not possible to edit the libreoffice page on the topic¹ unless you're logged in, and then there's no option to create an account (I'm not sure if it's just me: when I go to "Forgot password", it says my IP is blocked because there's an open proxy or something).

Could anybody with an account edit it to be more up-to-date?

1: https://help.libreoffice.org/Common/Distribution
Comment 8 Konstantin Kharlamov 2019-07-26 23:40:35 UTC
Actually, I just figured that even if you remove the option from Customize, it still appears if you select 3 or more objects. So, the magic switch to make it appear is having 3 objects selected.

The wiki article casually mentions that this option may distribute 3 or more objects, but I guess it would be nice to make it explicit that this option does not appear otherwise. That makes sense, given it distributes objects relative to each other, and in a sense just 2 objects are always optimally distributed. But it's not at all immediately clear, e.g. when I just found it, I wasn't sure whether it takes into account distance to page edges (in which case distributing 2 objects would make sense), and couldn't test that either.
Comment 9 Ming Hua 2020-10-24 15:39:56 UTC
FWIW, in 7.1 the menu "Distribution..." was changed to "Distribute Selection", and the dialog was changed to a submenu.  The behavior presumably didn't change.

Of course, the documentation in the help pages is still missing.
Comment 10 Roman Kuznetsov 2021-01-20 10:47:00 UTC
We have the Help for Distribution actions - https://help.libreoffice.org/latest/en-US/text/sdraw/guide/align_arrange.html?DbPAR=DRAW#bm_id3125863

and

https://help.libreoffice.org/latest/en-US/text/shared/01/05360000.html?&DbPAR=DRAW&System=WIN

But in 7.2 I see menu "Shape > Distribute selection" instead "Shape > Distribution".

So I just changed it for Help in https://gerrit.libreoffice.org/c/help/+/109678
Comment 11 Konstantin Kharlamov 2021-01-20 11:02:38 UTC
(In reply to Roman Kuznetsov from comment #10)
> We have the Help for Distribution actions -
> https://help.libreoffice.org/latest/en-US/text/sdraw/guide/align_arrange.
> html?DbPAR=DRAW#bm_id3125863
>
> and
>
> https://help.libreoffice.org/latest/en-US/text/shared/01/05360000.
> html?&DbPAR=DRAW&System=WIN

Please note that both of these still lacking the behavior documented.

I'll probably change the report title, so that the problem being the documentation would be clear without reading the whole discussion.
Comment 12 Commit Notification 2021-01-20 12:58:35 UTC
Roman Kuznetsov committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/d1564e769638b68222683ba6b4351b378c9d5585

tdf#126555 Change Distribution menu label to Distribute selection